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Audience 



The audience for the Volume Manager (UVM) Installation Guide is system 
administrators responsible for maintaining systems under the control of the 
UNISYS Volume Manager (UVM). 

This guide assumes that the user has a: 

■ working knowledge of the UNIX® system 

■ basic understanding of system administration 
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Scope 



This guide provides the user with installation procedures for the UNISYS Volume 
Manager. 

Organization 

The UNISYS Volume Manager (UVM) Basic User's Guide is comprised of 
three chapters, organized as follows: 

■ Chapter 1 — Installation of the Volume Manager 

Chapter 1 provides instructions for installing the Volume Manager from a 
cartridge tape and configuring your disk drivers for use with the Volume 
Manager. 

■ Chapter 2— General Volume Manager Configuration 

Chapter 2 discusses using the Volume Manager to create, mirror, and 
manage volumes. This chapter discusses the volassist utility. 

■ Chapter 3 — Deinstallation of the Volume Manager 

Chapter 3 provides instructions for deinstalling the Volume Manager from a 
system. 



Related Documents 

The following documents provide information related to the Volume Manager: 

■ The UNISYS Volume Manager (UVM) Release Notes provide up-to- 
date information about UVM that may not have been included in the manu- 
als. Please read the release notes first. 

■ The UNISYS Volume Manager (UVM) Basic User's Gi//c/e provides 
information about using the Volume Manager commands and utilities. 

■ The UNISYS Volume Manager (UVM) System Administrator's Guide 
provides detailed information about the of the Volume Manager interfaces, 
as well as advanced Volume Manager concepts. In addition to detailed 
information about the UNISYS Volume Manager, this guide contains the 
reference manual pages that describe the commands and utilities associated 
with the Volume Manager. 
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Conventions 



This guide uses several typographical conventions to identify certain types of 
information. Table 1 describes the typographical conventions used throughout 
this guide. 



Table 1: Typographical Conventions 



Convention 


Internretation 

II l&Wl Ml dClftl\#l 1 


constant width 


User input, computer output or prompts, com- 
mands and utilities, and the names of icons and 
configuration objects appear in constant 
width font. 


italic 


Titles of books and variables that the user types 
appear in text in italics. 


[ Sliift ) 


This is the Shift keyboard key. 




This is the F3 function key. Note: If your key- 
board does not include function keys, you 
can simulate its function by pressing CTRL- 
F followed by the key number. For example, 
for F3, press CTRL-Fand then 3. 




This is the up-arrow key. 




This is the down-arrow key. 


> 


This represents the pointer within menus. 
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Introduction 



This installation guide for the Unisys Volume Manager contains three parts: 

■ installation of the add-on package 

■ configuration and set up of the Volume Manager 

■ deinstallation of the add-on package 

Most of the commands used in the installation are in either the /sbin 
or the /usr/sbin directory. We recommend that you add both of 
these directories to your path environment variable. For example, 
using the Bourne Shell, modify your .profile with: 

PA'ni=/ sbin: /usr/sbin: $PATH export PATH 



NOTE 



Preparation 

Some of the installation processes require repeated reboots. You are asked for 
permission to reboot when the reboots are needed. If you choose not to reboot, the 
install will not complete. After the first reboot, the installation process takes con- 
trol of the system until the installation is complete. 

Before installing the Volume Manager, make sure you know what each of your 
disks contains. During the installation process, you will have to decide the fol- 
lowing: 

■ Do you wish to place all or just some of the disks on the system under 
Volume Manager control? 

■ Do you wish to place the system's root disk under Volume Management 
control (necessary in the case of a one disk system)? 

■ Do you wish to preserve, by encapsulating, any or all existing file systems 
and partitions under Volume Manager control? 

■ Do you want to manually chose between encapsulating and initializing a 
disk or leaving the disk alone (Custom Installation)? 

■ Do you want to encapsulate any disks with active partitions and initialize 
all others (Quick Installation)? 

Any disk you wish to be managed by UVM must have 512 blocks of free space. 
This space is used for storing disk group configurations and a disk label. This 



Installation of the Volume Manager 



1-1 



Introduction 



label ensures that the Volume Manager can identify the disk, even if it is moved to 
a different address or controller. 

The Volume Manager allocates 512 blocks (250K) for the disk group 
configurations and the label. This space is sufficient to handle normal disk group 
configurations for up to 15 or 20 disks. 



NOTE 



Although It Is not recommended, UVM does support the use of "unla- 
beled" disks after Installation. For more information, see the Unisys 
Volume Manager (UVM) System Administrator's Guide. 



The boot drive (the root disk) is a special case; if no other space is available, the 
Volume Manager will attempt to allocate space usually reserved for the swap par- 
tition. This process is known as "Swap Relocation" and will happen automatically 
during installation if necessary. 



Loading from a Cartridge Tape 

To load the package from cartridge tape, do the following: 

1 . Log in as root. 

2. Insert the installation tape cartridge in the tape drive. 

3. Enter: 

pkgadd -d ctapel uvm 

4. During the installation, you are asked if you want to install the UVM inter- 
face forms and menus for use with the Operations, Administration, and 
Maintenance (OA&M) menus. If you use or ever intend to use the OA&M, 
(a menu-o riented system administration aid), type y and press 

[ Return ] . Otherwise, answer n. 
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Unisys Volume Manager 
(i386at) 1.2 

Using </> as the package base directory. 
Copyright (c) 1991,1992,1993 Unisys Corporation. 
ALL RIGHTS RESERVED. 

THIS SOFTdlARE IS THE PROFERTV OF AND IS LICeiSED BY UNISYS CORPORATION, 
AND/OR ITS SUPPLIERS. 

You have the Operations, Administration, and Maintenance package installed. 
Would you like to add the UVM interface Forms and Menus? [y] 
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6. 



The system prints out a series of status messages as the installation 
progresses. No errors should be reported. 

Once the pkgadd process is complete, go to the section in this document 
entitled "Initializing UVM." 



Initializing UVM 

Once you have completed the package install, initialize UVM as follows: 

1 . If you choose to exclude one or more disks from being considered for 
Volume Manager control, you can add these disks to the 
/etc /vol /disks . exclude file. If you do not use the 
disks . exclude file, you are prompted for which disks to exclude. An 
example of the contents of the file follows: 

( \ 

cO.OdO 
cO.Odl 



2. Enter: 

volinstall 
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NOTE 



If you are upgrading from the 1 .1 .2 UVM release, do not run 
vol ins tall on those disks to be upgraded; use volupgrade 
instead. 



The vol ins tall program first examines all disks that it can find attached 
to the system and then lists them, vol ins tall then displays a menu of 
installation options with the following options: 
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Quick Installation 
Custom Installation 

Display help about menu 

Display help about menuing system 

Exit from menus 
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Selecting ? at this menu, and at most other prompts, displays a 
NOTE help file describing the current operation or menu choices. 

I Selecting ? ? at this, and at most other prompts, displays gen- 
' eral information about using voiinstall. 

Selecting q at this, and at all other prompts, exits from the 
current operation, or from the voiinstall program. 



4. The two main options for the voiinstall program are Quick Installation 
and Custom Installation, which can be selected by entering 1 or 2, respec- 
tively. For most installations. Quick Installation is sufficient. Custom Ins- 
tallation is used when your system has attached disks that you do not wish 
to convert for use with the Volume Manager. 



Quick Installation 

The Quick Installation option is the easiest to use. This option examines all disks 
connected to the system, encapsulates existing partitions (adds these partitions to 
the Volume Manager's control, leaving them intact and maintaining the integrity 
of the data), and initializes disks that do not have existing partitions. 
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The /etc /vf stab file is updated to ensure that file systems previously mounted 
on disk partitions will be mounted on volumes instead. 

To use the Quick Installation option, do the following: 

1 . Select menu item 1 from the vol ins tall menu. 

2. If Quick Installation finds a disk that has not been divided into partitions yet 
(disks that have not been added with diskadd), you are prompted with a 
question similar to the following: 

The cO . 0d2 disk does not appear to be prepared for t 
Add as a new disk [y,n,q,?] (default: y) 

3 . If you answer y (the default), the disk will be initialized and will be added 
as free space for use in creating volumes. If you answer n, the disk will not 
be added for use with the Volume Manager. 

4. After selecting Quick Installation and adding the new disks, reboot the sys- 
tem as described in the section "Rebooting After volinstall." 

Custom Installation 

Using Custom Installation allows you to control which disks are added to Volume 
Manager control and how they are added. This is important if you do not want all 
your disks under Volume Manager control. 

To choose Custom Installation: 

1 . Select menu item 2 from the vo 1 ins t al 1 menu. 

2. For the first disk (named cO . OdO), Custom Installation displays the fol- 
lowing: 
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Ihe cO.OdO disk is your Boot Disk. You cannot add it as a new 
disk. If you encapsulate it, you will make your root file system 
and other system areas on the Boot Disk into volumes. This is 
required if you wish to mirror your root file systen or system 
swap area. 

Encapsulate Boot Disk [y,n,q, ?] (default: y) 
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3 . If you answer y (the default), vo 1 ins tall encapsulates (turns disk parti- 
tions into volumes) your root and /stand file systems, along with your 
swap device and all other disk partitions found on your boot disk. 

4. For other disks the following choices are available: 



1 Install as a pre-existing disk, (encapsulate) 

2 Install as a new disk, (discards data on disk! ) 

3 Leave this disk alone. 
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If you choose the first option, volumes will be created to encapsulate any 
partitions on the disk. The /etc /vf stab file will be updated to ensure 
that file systems previously mounted on disk partitions will be mounted as 
volumes instead. 

If you choose the second option. Install as a new disk, the disk 
will be reinitialized. This destroys all data on the disk and makes the disk 
available as free space for allocating new volumes, or mirrors of existing 
volumes. 

Be careful when using this option as it may result in a loss of 
data. 




If you choose the third option. Leave this disk alone, then no 
changes will be made to the disk. If there are applications that use this disk 
that you do not wish to upgrade to use the Volume Manager, you can use 
this option to ensure that your applications can continue to use the disk 
without modification. 
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NOTE 



If you choose to leave all your disks alone, vol ins tall does 
not complete the installation of the Volume Manager or ask you 
for a reboot. 



Disks that are not added by vol ins tall for use with the Volume Manager can 
be added to the system later, either by using the voldiskadm menus or by using 
the voldiskadd utility. However, you must add at least one disk with vol in- 
stall before you can add disks using other utilities or interfaces. 



Rebooting After volinstall 

After you have customized all of the disks attached to your system, you must 
reboot the system to make changes to your disk partitioning that cannot be made 
while your disks are in use; several reboots may be required, depending on the 
setup you choose. The reboot begins automatically. 

The reboot procedure is as follows: 

1 . volinstall asks if you wish to reboot now. 

2. Enter y, to begin an immediate shutdown. 

Enter n to cause volinstall to exit without starting a shutdown. 

3 . If you choose not to shutdown immediately, you should shutdown the sys- 
tem at the earliest convenient opportunity. 

Do not make any changes to your disk and file system 
configurations before shutting down and rebooting your sys- 
tem. 



4. During the next one or two reboots, you may be ask ed several times if you 
wish to continue an operation. Press the ( Return ] key at all of these 
prompts to accept the default answer. 

If you select a different answer from the default for any of these prompts, or 
press q, installation may fail. 
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Introduction 



Once the Volume Manager has been successfully installed, This section provides 
various examples of how to use the Volume Manager for creating, mirroring, and 
managing volumes. These examples are intended to help you to initially configure 
your system. Refer to the Unisys Volume Manager (UVM) Basic User's 
Guide and the Unisys Voiume Manager (UVM) System Administrator's 
Guide for more complete information on how to use the Volume Manager. 

General Use of the volassist Utility 

The volassist utility is a simple way to create and manage volumes from the 
command line. Use volassist to create, mirror, grow, shrink, and backup 
volumes. Select the specific action to perform by specifying an operation key- 
word as the first argument on the command line. For example, the keyword for 
creating a new volume is make; therefore, you can create a new volume by enter- 
ing: 

volassist make voiume-name length 

The first argument after any volassist keyword is always a volume name. Fol- 
low the volume name with a set of attributes. Use these attributes to specify 
where to allocate space, and whether you want mirroring or striping to be used. 

You can select the disks on which the volumes are to be created by specifying the 
disk names at the end of the command line. For example, to create a 30 megabyte 
striped volume on three specific disks (disk03, disk04, and diskOS), enter: 

volassist make stripevol 30m layout=stripe disk03 disk04 diskO! 

To see a list of available disks, use the voldisk list command, voldisk 
list provides a list of all disks available to the Volume Manager. The output of 
voldisk list lists the device name, the type of device, the disk name, the 
group to which the disk belongs, and the disk's status. The disk names are listed 
in the column labeled DISK. 

The following is an example voldisk list output: 
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DEVICE TYPE DISK GROUP STATUS 

cO.OdOsO sliced diskOl rootdg online 

cO.OdlsO sliced disk02 rootdg online 

c0.0d2s0 sliced disk03 rootdg online 



NOTE 



volassist, voldiskadm and voldiskadd allow you to enter your 
own disk name or choose the default disk name. The default disk 
name in this case is disknn, where nn is a two-digit number. 

' Disks in disk groups other than rootdg have default names made up 
of the disk group name followed by two or more digits. 

Refer to the Unisys Volume Manager (UVM) Basic User's Guide, the Unisys 
Volume Manager (UVM) System Administrator's Guide, or the 
volassist(lm) man page for more information on operations, options, and 
attributes for the volassist utility. 



Device Names versus Disk names 

When you perform disk administration, it is important that you recognize the 
difference between a device name and a disk name. 

The device name (sometimes referred to as devname or disk access name) is 
the location of the disk. The syntax of a device name for an internal SCSI channel 
is cx,ydzsn, where: 

X is the controller type (for example, normally 0). 
y is the controller number (for example, normally 0). 
z is the logical disk number of the target disk. 
n is the number of the disk slice. 

The syntax of a device name for an ISIC channel is cw.xdyzsn, where: 

wis the controller type (for example, 1 is an ISIC board). 

xis the controller number (for example, the EISA slot where the ISIC is located). 

y is the bus number. 

z is the SCSI ID of the drive. 
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n is the number of the disk slice. 

The full pathname of a device is /dev/dsk/c/ewcename. In this document, 
only the device name is listed and /dev/dsk is assumed. An example of a dev- 
ice name is cO . OdOsO. A suffix of sO is used to indicate default disk partition- 
ing. Normally, you would not use any other suffix. 

The disk name is an optional administrative name for the disk, such as diskOl. 



Adding New Disks 

To add a new disk to your system after initial installation, use the voldiskadd 
command. For example, to attach a new disk named cl.4dl4: 

1. Enter: 

voldiskadd cl.4dl4 



NOTE 



Notice that the sO suffix is not used. 



2. voldiskadd prompts you for a disk group name and a disk name. Nor- 
mally, the default disk group, rootdg, should be used. You can create 
your own disk name, or use the default disk name. You should remember 
the disk name assigned to the disk. You may wish to label the disk drive 
cabinet, if possible. 

If you are planning to use the drive in a Ready Reserve or MassCab-2 
Dual Initiator configuration, you need to create another disk group for 
the drives (normally MassCab drives, since they can be shared 
between two systems). 



NOTE 
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Reserving Disks 

By default, vol assist allocates space for volumes from any disk that has free 
space. You may wish to reserve some set of disks for special purposes, such as to 
avoid general use of a particularly slow or a particularly fast disk or to avoid gen- 
eral use of available space on the boot disk. To reserve a disk for special pur- 
poses, enter: 

voledit set reserve=yes diskname 

After you enter this command, volassist will not allocate space from the 
selected disk unless that disk is specifically mentioned on the volassist com- 
mand line. For example, if disk disk03 is reserved, the command: 

volassist make vol03 20m disk03 
creates a 20 megabyte volume on diskOB. However, the command: 

volassist make vol04 20m 
does not use disk03, even if there is no free space on any other disk. 
To turn off reservation of a disk, enter: 

voledit set reserve=no diskname 



Mirroring the Boot Disk 

You can mirror your boot (root) disk onto another disk in two ways: with vol - 
diskadd (shown here) and voldiskadm (see the Unisys Volume Manager 
(UVM) Basic User's Guide). This makes it possible to recover from failure of 
your boot disk by replacing it with the mirror of the boot disk. 

To mirror your boot disk, do the following: 

1 . Select a disk that is at least as large as your boot disk. 

2. Use the vol diskadd command to add the selected disk as a new disk (if 
it is not ah-eady added). 

3 . Execute the following command: 

/etc/vol /bin/ volrootmir altemate-disk 
where altemate-diskis the disk name assigned to the disk. 
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4. volrootmir creates mirrors for the following volumes: 

■ rootvol — contains the volumes for the root file system. 

■ swapvol — is the primary paging device. 

■ standvol — is a file system used for booting the operating sys- 
tem. 

The alternate boot disk is configured to enable booting from it if the pri- 
mary boot disk fails. 

5 . There may be other volumes on the boot disk, such as volumes for /var, 
/usr, / Ihome, or / tmp file systems. These must be mirrored separately 
using the volassist utility. For example, if you have a /usr file sys- 
tem on a volume usrvol, you can mirror it to alternate-disk using the 
conunand: 

volassist mirror usrvol altemate-disk 

6. If you do not have space for a copy of some of these file systems on your 
alternate boot disk, you can mirror them to other disks. You can also span 
or stripe these other volumes across other disks attached to your system. 

To list all volumes on your primary boot disk, use the command: 

volprint -t -v -e 'aslist.aslist.sd_disk=" diskOl" ' 

By default, the primary boot disk is "diskOl." If you chose another disk 
name as the primary boot disk, use that name. 

7. To mirror all of the simple volumes on this disk to your alternate boot disk, 
use the command: 

volmirror diskoi altemate_disk 

If you have any problems creating you alternate boot disk, refer to your sys- 
tem service guide for more information. 
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Creating New Volumes 

To create a new volume, enter: 

vol assist make volume-name length 

Where volume-name is a name to give to the volume, and length specifies the 
number of sectors in the volume. This length can be specified in kilobytes or 
megabytes by using a suffix character on the length of k or m. 

To create a 30 megabyte volume named vol 01, use the command: 

volassist make volOl 30m 
To specify 30 megabytes in blocks, use: 

volassist make volOl 61440 

Other units of measurement can be used to specify volume lengths. Refer to the 
volassist manual page for more information. 

Creating a volume creates two device node files that can be used to access the 
volume: /dev/vol/v'o/wme-nameand /dev/irvol/ volume-name. These 
files are the block and raw device nodes for the volume, respectively. 

Creating a File System on a Volume 

To create a file system on a volume, do the following: 

1 . List the volume to see its length, in sectors, using the command: 
volprint -tvh volume-name 
For example, printing volume vol 01 might yield the output: 
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V NAME 
PL NAME 
SD NAME 

V volOl 

pi volOl-01 
sd diskOl-01 



USETYPE KSTATE STATE LENGTH 

VOLUME KSTATE STATE LENGTH 

PLEX PLOFFS DISKOFFS LENGTH 

fsgen DISABLED ACTIVE 61440 

volOl DISABLED RECOVER 61440 

volOl-01 0 32768 61440 



READPOL PREFPLEX 
LAYOUT ST-WIDTH MODE 
DISK-MEDIA ACCESS 



SELECT 
CONCAT 
diskOl 



RW 

cO.OdlsO 
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2. Create a file system on vol 01 of this length (for example a s5 file system) 
using the command: 

mkfs -F s5 /dev/rvol/volOl 61440 

3 . Specify the mount parameters for this file system in the file 

/etc /vf s tab. To specify default mounting parameters for vol 0 1, 
using a mount point of /volOl, add the following line to /etc/vf stab: 

/dev/vol/volOl /dev/rvol/volOl /volOl s5 1 yes - 

4. Mount this volume with the command: 

mount /vol 01 

5 . The volume will be remounted automatically on startup. 



Removing Volumes 

To remove a volume: 

1 . Remove all references to the volume. 

2. If the volume is mounted as a file system, unmount it. 

3. If the volume is Usted in /etc/vf stab, remove its entry. 

To remove the volume device and return all space that it is using to free disk 
space, use the command: 

vol edit -rf nti volume-name 
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For example, to remove the vol 01 volume: 

1. Unmount it with: 

umount /dev/vol/volOl 

2. Remove its entry from /etc /vf stab. 

3. Remove the volume device with: 

voledit -rf rm volOl 

Mirroring All Volumes 

To mirror all existing volumes to available disk space, type: 
volmirror -a 

You can also configure the Volume Manager to create mirrored volumes by 
default. To do this, enter the command: 

volmirror -d yes 

If you make this change, you can still make unmirrored volumes by specifying 
ninirror=l as an attribute to the volassist command. For example, to 
create a nonmirrored 20 megabyte volume named nomirror, use the command: 

volassist make nomirror 20m nmirror=l 
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This chapter describes the steps involved in deinstalling the Volume Manager 
package. 



Preparation for Deinstallation 

If the Volume Manager needs to be removed, the following preparations must be 
completed before you perform the deinstallation: 

■ All file systems and other applications that use volume devices must be 
modified to use the underlying disk devices. 

■ Make sure that a disk partition device can be used to access any file systems 
which have been created since the Volume Manager was installed. 

■ All data from any volumes that were created from multiple regions of 
storage, including striped or spanned volumes, must be moved onto a single 
subdisk. 

■ Any mirror copies of all file systems and other databases should be removed 
so that only one copy remains that starts on a partition boundary. 

To display the list of all volumes, use the command: 

volprint -Ath 

■ If any volume contains more than one plex (mirror), all but one plex should 
be removed. 

To remove a plex, use the command: 
volplex -o rm dis plex-name 




Leave exactly one plex for the special volumes rootvoi, swap- 
vol, and standvol. Make the remaining plex for each volume 
consist of one subdisk on device cO . OdlsO. These subdisks 
must be either the original subdisks created by running vol in- 
stall or they must have been created using volrootmir or 
the voldiskadm ndrror disk operation. 
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If any remaining plex has more than one subdisk, consolidate those sub- 
disks into a single plex. A simple way to do this is to use the commands: 

volassist mirror volume-name layout=contig 
volplex -o rm dis plex-name 

This operation wont worl< if you do not iiave sufficient space on 
NOTE anotlier disk. 



Modify the /etc /vf stab to mount all file systems using a partition device 
instead of the volume device. 

Create partitions for each volume using the prtvtoc and edvtoc utilities 
to update the Volume Table of Contents (VTOC) on each drive. 



NOTE 



The entry for /stand in /etc/vf stab file is updated automati- 
cally when you invoke the command 
/etc/vol/bin/volxmroot, as described below. 



Due to the potential for inadvertently making mistakes during a de- 
installation it is recommended that you back up the system fully onto tape. 



Deinstallation Procedures 

The following are the procedures to follow to deinstall the Volume Manager: 

1 . In deinstalling the Volume Manager, volumes for the root, swap, and 

/stand file system devices must be converted back to using disk partitions. 
Once all mirror copies of root have been removed, reconfigure the kernel by 
running the command: 

/ etc / vol /bin/ volunroot 

This removes all changes that were made to the system to support booting 
from a root volume. This also updates the /etc/vf stab file to replace the 
entry for /stand, if you have not done so already. The system should be 
rebooted before continuing. 



3-2 



Unisys Volume l\/lanager (UVM) Installation Guide 



Introduction 



2. After rebooting, there should no longer by any volumes in use. To check 
for volumes that are still in use, use the command: 

volprint -Aht -e v_open 

If any volumes are listed, determine what application or file system is using 
each volume. One way you can determine which applications reference the 
listed volumes is to rename the volume, so that the application can not find 
the volume under its original name. To rename a volume, enter: 

voledit rename old_vol_name new_vol_name 

3. If you have to rename any volumes, reboot again to ensure that the volumes 
are no longer in use. 

4. After rebooting, use volprint once more to ensure that no volumes are in 
use. Applications that reference the volume prints error messages to the 
console that may be useful for converting those applications. 

5 . Shut down the Volume Manager by entering: 

voldctl stop 
voliod -f set 0 

6. To remove the Volume Manager package, use the command: 

pkgrm uvm 



Deinstallation of the Volume Manager 
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Audience 



The audience for the Unisys Volume Manager Basic User's Guide is system 
administrators responsible for maintaining systems under the control of the Unisys 
Volume Manager. 

This guide assumes that the user has a: 

■ working knowledge of the UNIX® system 

■ basic understanding of system administration 
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Scope 



The purpose of this guide is to provide the user with the basic and most commonly 
used procedures for volume management and system administration using the 
Unisys Volume Manager. 

Organization 

The Unisys Volume Manager Basic Uset's Guide is comprised of three 
chapters, organized as follows: 

■ Chapter 1 — Introduction to the Volume Manager 

Chapter 1 provides general information about volume management and 
related concepts. This chapter also contains a list of relevant terms. 

■ Chapter 2 — ^Menuing Interfaces 

Chapter 2 discusses the basic disk and volume operations available via the 
Volume Manager Support Operations and the Operations, Administration, 
and Maintenance (OA&M) menus. 

■ Chapter 3 — Command Line Interface 

Chapter 3 contains information about the command line interface available 
with the Volume Manager. 



Related Documents 

The following documents provide information related to the Volume Manager: 

■ The Unisys Volume Manager (UVM) Release A/ofes contains the most 
up-to-date information about UVM and should be read first. 

■ The Unisys Volume Manager (UVM) Installation Guide contains the 
instructions necessary to install the Volume Manager software. 

■ The Unisys Volume Manager System Administrator's Guide providGs 
more detailed information about the Volume Manager command line inter- 
face, as well as advanced Volume Manager concepts. In addition to 
detailed information about the Unisys Volume Manager, this guide contains 
the reference manual pages that describe the various commands and utilities 
associated with the Volume Manager. 
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Using This Guide 

This guide describes how to perform basic Volume Manager system administra- 
tion functions. UVM administration functions can be performed using menus, a 
command line interface, or a Graphical User Interface. 

This guide focuses on the simpler approaches to Volume Manager administration, 
as offered by the following interfaces: 

■ The Volume Manager Support Operations for disk administration (described 
in Chapter 2) 

■ The OA&M menu interface for volume administration (described in 
Chapter 2) 

■ Simple command line interfaces (described in Chapter 3) 
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Conventions 



This guide uses several typographical conventions to identify certain types of 
information. Table 1 describes the typographical conventions used throughout 
this guide. 



Table 1: Typographical Conventions 



Convention 


I nteroretation 

II llWl mI WlMfclWl 1 


constant width 


User input, computer output or prompts, com- 
mands and utilities, form names, menu items, 
and the names of icons and configuration enti- 
ties appear in constant width font. 


italic 


Titles of books and variables that the user types 
appear in text in italics. 


[ Shift ] 


This is the Shift keyboard key. 




This is the F3 function key. If your keyboard 
does not include function keys, you can simulate 
a function key by pressing CTRL-F followed by 
the key number. For example, for F3, press 
CTRL-F and then 3. 




This is the up-arrow key. 




This is the down-arrow key. 


> 


This represents the pointer within menus. 
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Introduction 



This chapter provides a general introduction to the Unisys Volume Manager 
(UVM). The Unisys Volume Manager is a disk management tool that increases 
data availability and improves disk I/O performance. 

The Volume Manager can be used to: 

■ Simplify the management of the disk configuration by providing convenient 
operations to add, move, replace, and remove disks. 

■ Protect against data loss due to hardware malfunction by creating a mi/ror 
(duplicate) image of important file systems and databases. 

■ Change the disk configuration without rebooting or otherwise interrupting 
users. 

■ Perform file system backup while the system is in active use. 

■ Increase disk perforaiance through the use of striping (division of volumes 
and file systems across several physical disks). 

This chapter begins with an overview of how disk storage management is accom- 
plished in a UNIX system that does not make use of the Volume Manager. Then, 
the principles of disk storage management using the Volume Manager are intro- 
duced. This chapter goes on to describe how disk failure protection can be 
achieved by using mirroring. Finally, some more advanced concepts for perfor- 
mance improvement and support of disk groups are introduced. 

How the Volume Manager Works 

The basic principles of disk storage management using the Volume Manager are 
introduced by reviewing some key elements of disk storage management as fol- 
lows: 

■ Space allocation 

For each file system or database created, disk space must be allocated. As 
space requirements can change over time, it must also be possible to alter 
the space allocation. It should also be noted that the manner in which data is 
allocated can have a significant performance impact, since it influences disk 
head movements as well as the distribution of accesses across disk drives. 
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■ Addressing 

File systems, Data Base Management Systems (DBMS), and system 
administrators must be able to address the space allocated for a particular 
file system or database. 

■ Data access 

File systems, Data Base Management Systems, and system administrators 
must be able to store and retrieve data through an appropriate API (Applica- 
tion Progranmiing Interface). 
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Disk Storage Management Without the 
Volume Manager 



This section describes disk storage administration of UNIX systems that do not 
use the Volume Manager. 

■ Space allocation 

To allocate space for file systems or databases, disks are divided into parti- 
tions (also called slices). A partition is defined by its start address on the 
physical disk and its length. 

■ Addressing 

A partition is addressed through a physical address, generally referred to as 
the device name or devname. The syntax of a device name for an inter- 
nal SCSI channel is cx.ydzsn, where: 

X is the controller type (for example, normally 0). 
y is the controller number (for example, normally 0). 
z is the logical disk number of the target disk. 
n is the number of the disk slice. 

The syntax of a device name for an ISIC channel is cw.xdyzsn, where: 

wis the controller type (for example, 1 is an ISIC board). 

X is the controller number (for example, the EISA slot where the ISIC is 
located). 

y is the bus number. 

z is the SCSI ID of the drive. 

n is the number of the disk slice. 

The full pathname of a device is /dev/dsk/devicename, 

■ Data access 

Storage and retrieval of data on a partition is achieved through the so-called 
block and character device interfaces, a standard API used by file systems 
and Data Base Management Systems. 

Figure 1 gives an overview of how disk storage is allocated, addressed and 
accessed in UNIX systems that do not make use of the Volume Manager. 
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Figure 1-1 : Disic Storage i\/lanagement Without Volume Manager 
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There are a number of drawbacks associated with this scheme: 

■ The system administrator must partition the disks according to the needs of 
the users on the system. The administrator must keep a record of how the 
drives are partitioned, since no record is kept within the system. 

■ Slices cannot be moved or extended in size, therefore, changes in the space 
needed by a file system or database require that the administrator: 

1 . Make the system unavailable for normal use. 

2. Back up all data to a tape. 

3. Repartition the drives to reflect the space changes required. 

4. After the repartitioning is complete, restore the data from the tape. 

5 . Make the system available for use. 
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■ Partitions cannot exceed the size of a physical disk. 

■ Reconfiguring disks (for example moving a disk to a new controller) results 
in a change of the addresses through which the partitions on the disk are 
accessed. This requires the administrator to perform manual actions to 
change all references to the partitions on the disk drives involved. 

In addition, the fact that the partitioning of disks cannot be changed easily makes 
it difficult for the administrator to ensure that data is placed on the available disk 
drives for optimal performance. 
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This section describes disk storage management of UNIX systems using the 
Volume Manager. 

■ Space allocation 

The Volume Manager is able to fully manage the allocation of space on the 
disk drives connected to a system. This is achieved in the following 
manner: 

- It creates two partitions on each physical disk: a small partition in 
which it keeps its disk label and other administrative data and a 
large partition that covers the remainder of the disk. A symbolic 
name (the disk name or disk media name) can be established to 
refer to a disk that is managed by the Volume Manager (for exam- 
ple: diskOl, disk02). 

- Space for a file system or raw database partition is obtained by 
creating a voiume of the appropriate size. A volume is built from 
one or more areas of disk space (also called "subdisks") located on 
one or more physical disks. The administrator can leave the space 
allocation completely up to the Volume Manager or keep a select- 
able amount of control over where space is allocated. 

■ Addressing 

Volumes are addressed using a voiume name that is independent of the 
manner in which the volume is mapped onto physical disks. 

■ Data access 

Volumes can be accessed through the standard block/character device inter- 
face. This means that applications do not have to be changed to use tiie 
Volume Manager. 

To maintain data on volumes in a consistent state in the face of device failures, the 
Volume manager differentiates between two types of volumes: volumes that have 
file systems located on them (usage type fsgen) and all other types of volumes 
(usage type gen). 

Figure 2 gives an overview of how disk storage is allocated, addressed and 
accessed in systems that make use of the Volimie Manager. 
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Figure 1-2: Disk Storage Management With the Volume Manager 
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As compared to the situation without Volume Manager, this scheme offers a number of 
advantages: 

■ The Volume Manager maintains complete disk space administration, thereby free- 
ing the administrator from the task of partitioning disks and maintaining the space 
administration. However, it remains possible for the administrator to keep control 
over the space allocation. 

■ ■ Volumes can be extended or reduced in size as needed, widiout interrupting access 
to data. 

■ Volumes can be built from disjunct areas of disk space located on one or more phy- 
sical disks. This makes it possible to extend volumes by adding disk space that is 
not contiguous with the space already allocated, and to create volumes that exceed 
the size of a physical disk. 

Two types of volumes that use space from more than one physical disk are con- 
catenated \o\umQs and spanned volumes. Concatenated volumes consist of one 
or more discontiguous segments of disk space. Spanned volumes consist of space 
from more than one disk. 

■ Volumes are referenced volume names that are independent of the physical storage 
addresses used by the volume. As part of the administrative information on each 
physical disk, the Volume Manager maintains a unique identification of the disk. 
This makes it possible to automatically readjust its volume and space administra- 
tion in case disks are moved in the configuration. 



1-8 



Unisys Volume Manager (UVM) Basic User's Guide 



Mirroring 



In a system without the Volume Manager, failures of a physical disk result in loss 
of the data on that disk. To recover from such an event, the data needs to be 
restored from a backup and all changes made to the data since that backup have to 
be re-applied. This is a time-consuming process during which applications have 
no access to the data. 

The Volume Manager makes it possible to protect critical data against disk 
failures by maintaining multiple copies (called "mirrors" or "plexes") of the data in 
a volume. Figure 3 shows how this is achieved. 
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Figure 1-3: l\/lirroring Using tlie Volume l\/lanager 
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Mirroring Boot and Swap 

The disk from which a system is booted (also referred to as the "boot disk") has to 
contain a boot track (at a location that is fixed by convention) and 3 partitions that 
are used by fiimware and operating system software before the Volume Manager 
is operational. These partitions are: 

■ The "stand alone partition" (containing the kernel executables) 

■ The "root partition" (containing the root file system) 

■ The "swap partition" (the primary paging device) 

By convention, specific tags are used for these partitions. 

To allow a system to boot in case the root disk has failed, a second disk can be set 
up, with a boot track and the three partitions mentioned above. 

The volume mirroring scheme as explained in the previous section cannot be used 
to mirror the root disk because it does not provide a method to access some of the 
data required for reboot (the boot track). Additionally, this mirroring scheme does 
not provide a method to access the required partitions using the conventions men- 
tioned above. 

For these reasons, the Volume Manager provides a simple way to create a secon- 
dary root disk. This method ensures that the secondary root disk has a boot track 
in ^e proper location and that the stand alone, root and swap partitions are acces- 
sible as partitions according to the conventions mentioned above. 

Figure 4 gives an example of how root disk mirroring is achieved. For simplicity, 
it only shows the mirrored root volume; mirrored volumes that encapsulate the 
swap and stand alone partitions are also created. 
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Figure 1-4: Root disic mirroring using tlie Voiume l\/lanager 
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The following sections describe some of the advanced operations available with 
the Volume Manager. 



Striping 

As mentioned earlier, the manner in which storage space is allocated to file sys- 
tems and databases has a direct impact on disk head movements and on the distri- 
bution of the I/O load between disk drives. An optimal allocation minimizes head 
movements and distributes the I/O load evenly between disk drives. 

By supporting striping (in addition to concatenation) as a storage allocation 
scheme for plexes (minors), the Volume Manager makes it possible to evenly dis- 
tribute the VO load for a plex across a number of disk drives. A striped plex con- 
sists of a number of equal sized subdisks, each located on a separate disk drive. 

Data is allocated on the subdisks in stripe blocl<s of a fixed size (referred to as the 
stripe width). Stripe blocks are interleaved between the subdisks as shown in 
Figure 5, resulting in an even distribution of accesses between the subdisks. 



NOTE 



The effect of striping on performance is dependent on the choice of 
the stripe width and on application characteristics. The Volume 
Manager uses a default stripe width of 128 sectors that has been 
chosen to give good results in typical multi-user, business application 
environments. 
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Figure 1-5: Striping With the Volume lUlanager 
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Disk Groups 

There can be situations in which all data related to a particular set of applications 
or a particular group of users needs to be made accessible to another system. 
Examples of this are: 

■ Moving the data from a failed system to another system while maintaining 
the Volume manager configuration on the taiget system. 

■ Balancing the woik load across a number of systems. 

In such cases, it is important that the data related to particular application(s) or 
users is located on an identifiable set of disk drives, such that when these drives 
are moved, all data of the application(s) or group of users is moved as a unit and 
no data of other applications or users is moved. 

To make this possible, the Volume Manager supports the concept of disk groups. 
A disk group is a set of physical disk drives which are administrated separate from 
any other disks or disk groups on the system. A volumes is always contained in a 
single disk group. This allows the system administrator to create separate disk 
groups for specific applications or user groups and have all data associated with 
the applications or group of users located on the associated disk group. The 
Volume Manager provides convenient facilities to export and import disk groups. 



NOTE 



On most systems, the use of disk groups is not necessary. The 
Voiume Manager supports a default 6\sk group, the "root disk group" 
(rootdg), in which all volumes are created If no further specification is 
given. 
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The Volume Manager can be used at various levels, ranging from a relatively sim- 
ple level to an extremely advanced level. At the most basic level, minimal UVM 
knowledge is required of the user. At the more advanced levels, a thorough 
understanding of undedying UVM concepts is required. 

Any of the UVM interfaces can be used interchangeably, although some may not 
be available on certain systems. Volume Manager objects created by one inter- 
face are fully inter-operable and compatible with those created by the other inter- 
faces. 

This guide focuses on how basic disk and volume administration can be per- 
formed, using the menu-driven interfaces (The Volume Manager Support Opera- 
tions and the OA&M interface), and the command-line interface. The Unisys 
Volume Manager (UVM) System Administrator's Gu/cfe should be consulted 
for more advanced information on UVM and its utilities. 

UVM administration functions can be performed in various ways: 

Volume Manager Support Operations 

The Volimie Manager Support Operations interface provides a 
menu driven interface for performing disk administration func- 
tions. 

OA&M Interface 

The OA&M menu-driven interface permits the user to specify 
operations and data using menus and forms. 

Command Line Interface 

The Volume Manager command line interface consists of a 
number of comprehensive commands that range from simple com- 
mands, requiring a single piece of information, to complex com- 
mands, requiring detailed input. Many of the UVM commands 
require a thorough understanding of Volume Manager concepts. 
These are intended to be used by programs and Shell scripts. 
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Introduction 



This chapter describes the Volume Manager Support operations and the Opera- 
tions, Administration, and Maintenance (OA&M) interface. These are menu- 
driven interfaces designed for use with the Volume Manager. These interfaces are 
used to perform physical and logical device administration. 

The Volume Manager allows you to do two types of administration: 

Physical device administration 

Physical device administration is the management of the physical 
disk device. Physical device administration includes putting a 
device under Volume Manager control or removing a device from 
Volume Manager control. 

Volume and file system administration 

Volume and file system administration includes the creation and 
removal of volumes and file systems. 

Currently, the Volume Manager Support (voldiskac3m) operations provide menus 
for performing physical device administration. These menus are designed to be 
easy to use. The menus provide information about each step to help you decide 
the correct response for each prompt. 

The OA&M interface provides menus for performing basic physical disk, volume, 
and file system administration tasks provided with the Volume Manager. Due to 
the complex interface requirements of the Forms and Menu Language Interface 
(FMLI), the menuing package on which OA&M is based, OA&M does not pro- 
vide the full functionality of UVM. Eventually, OA&M is to be replaced by the 
Volume Manager Support operations. 
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This section describes how to use the Volume Manager Support Operations to per- 
form physical device administration tasks. 

This section describes how to: 

■ Add a disk to Volume Manager control 

■ Remove a disk 

■ Replace a failed disk 

■ Mirror volumes on a disk 

■ Move volumes from a disk 

■ Enable or disable a disk group 

■ Enable or disable a disk device 

■ List disk information 

Starting the Volume Manager Support Operations 

To start the Volume Manager Support Operations, enter: 
voldiskadm 

The Volume Manager displays a menu containing the disk operations available to 
you. 
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The voldiskadm Main Menu 



Figure 2-1 : Ttie Volume Manager Support Operations Main Menu 

rr \ 

Volume Manager Suqpport Operations 
Menu: VoltunSManager/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Remove a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Enable access to (inport) a disk grovgp 

9 Remove access to (deport) a disk group 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 

? Display help about menu 

?? Display help about the menuing system 

q Exit from menus 

Select an operation to perform 



The ? command may be entered at any time to provide iielp in using thie 
NOTE menu. Tiie output of ttie ? command is a list of operations and a definition 
of eacli. 

^ Tiie ? ? command gives you a list of inputs that can be used at any prompt. 

The q command brings you back to the main menu if you need to restart a 
process; however, using q at the main menu level exits the Volume Manager 
Support Operations. 
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Add or initialize a disk 

This menu operation allows you to add formatted disks to the sys- 
tem. SCSI disks are already formatted. For other disks, see the 
manufacturer's documentation for formatting instructions. You 
are prompted for a disk device name and a disk group name, 
which is optional. If you specify a disk group, the disk is added to 
that disk group. Otherwise, the disk is held as a spare, to be used 
for future operations or disk replacements, without needing to be 
initialized at that time. If the disk has not been initialized already, 
the disk is partitioned and initialized for use with the Volume 
Manager. 

Encapsulate a disk 

This menu operation is used to bring a disk that was added to the 
system before installing the Volume Manager under Volume 
Manager control. You are prompted for a disk device, a disk 
group, and a disk name. The disk is added to that group. The disk 
is examined to search for partitions that are used for file systems 
or other purposes. Volumes are created to replace disk partitions 
as the means of accessing the data. If the encapsule operation 
cannot determine the purpose of a partition automatically, you are 
asked what to do with it. You can choose to replace the partition 
with a volume, leave the partition alone, or remove the partition. 

You must reboot the system if any partitions are being used for 
mounted file systems or for running applications. You may have 
to modify application configuration files to use volumes, rather 
than direct disk devices, to access the disk partitions. File system 
mount information is adjusted automatically. 

Remove a disk 

This menu operation is used to remove a disk from a disk group. 
You are prompted for the name of a disk to remove. You cannot 
remove a disk if any volumes use storage on that disk. If any 
volumes are using storage on the disk, you have the option of ask- 
ing the Volume Manager to move that storage to other disks in the 
disk group. 
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NOTE 



You cannot remove the last disk in a disk group using 
tliis operation. If you wish to use all the remaining 
disks in a disk group for some purpose, you should 
disable (deport) the disk group. You will then be able 
' to reuse the disks. 

Remove a disk for replacement 

This menu operation is used to remove a physical disk from a disk 
group, while retaining the disk name. This changes the state for 
the named disk to removed. If there are any initialized disks that 
are not part of a disk group, you are given the option of using one 
of these disks as a replacement. 

Replace a failed or removed disk 

This menu operation is used to specify a replacement disk for a 
disk that you removed with the Remove a disk for 
replacement menu entry, or one that failed during use. You 
are prompted for a disk name to replace and a disk device to use 
as a replacement. You can choose an uninitialized disk, in which 
case the disk will be initialized, or you can choose a disk that you 
have already initialized using the Add or initialize a 
disk menu operation . 

Move volumes from a disk 

This menu operation moves any volumes (or parts of a volume) 
that are using a disk onto other disks. Use this menu operation 
immediately prior to removing a disk, either permanently or for 
replacement. 



NOTE 



Simply moving volumes off a disk, without also remov- 
ing the disk, does not prevent other volumes from 
being moved onto the disk by future operations. 



Enable (import) a disk group 

This menu operation enables access by this system to a disk 
group. If you wish to move a disk group from one system to 
another, you must first disable (deport) it on the original system. 
Then, move the disks from the deported disk group to the other 
system and enable (import) the disk group there. 
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You are prompted for the device name of the disk on which the 
disk group was created. All enabled (online) disks are searched to 
locate all disks that are in the same disk group as the disk whose 
device name you entered. 

Disable (deport) a disk group 

This menu operation disables access to a disk group that is 
currently enabled (imported) by this system. Deport a disk group 
if you intend to move the disks in a disk group to another system. 
Also, deport a disk group if you want to use all of the disks 
remaining in a disk group for some new purpose. 

You are prompted for the name of a disk group. You are asked if 
the disks should be disabled (offlined). For removable disk dev- 
ices on some systems, it is important to disable all access to the 
disk before removing the disk. 

Enable (online) a disk device 

If you move a disk from one system to another during normal sys- 
tem operation, the Volume Manager will not recognize the disk 
automatically. Use this menu operation to tell the Volume 
Manager to scan the disk to find what disk it is, and to determine 
if this disk is part of a disk group. Also, use this operation to re- 
enable access to a disk that was disabled by either the disk group 
deport operation or the disk device disable (offline) operation. 

Disable (offline) a disk device 

This menu operation is used to disable all access to a disk device 
through the Volume Manager. This operation can be applied only 
to disks that are not currently in a disk group. Use this operation 
if you intend to remove a disk from a system without rebooting. 

Many systems do not support disks that can be 
removed from a system during normal operation. On 
such systems, the offline operation is seldom useful. 



NOTE 
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List disk information 

This menu operation is used to display the list of disks attached to 
your system. This will also list removed or failed disks. 

You can also use this operation to list detail for a particular disk. 
This detail includes, among other things, the disk group of which 
the disk is a member, even if that disk group is currently disabled. 



Disk Operations 

This section describes the disk operations available with voldiskadm. 

Adding Disks 

When you add a disk to a system that is running UVM, you may wish to put the 
disk under control of UVM so that it can control the space allocation on the disk. 
If the disk was previously in use, but not under UVM control, then you may wish 
to preserve existing data on the disk while still letting UVM take control of the 
disk. This can be accomplished using the encapsulation function of UVM (see 
"Adding an Initialized Disk"). If the disk is new, then it will need to be initialized 
(see "Initializing a New Disk"), If a disk was previously not under UVM control, 
but no data is required to be preserved, an initialization operation should be per- 
formed (see "Adding a Initialized Disk"). 

When you perform disk administration, it is important that you recognize the 
difference between a device name and a disk name. 

The device name (sometimes referred to as devname or of/s/f access name) is 
the location of the disk. The syntax of a device name for an internal SCSI channel 
is cx.ydzsn, where: 

xis the controller type (for example, normally 0). 
y is the controller number (for example, normally 0). 
z is the logical disk number of the target disk. 
n is the number of the disk slice. 

The syntax of a device name for an ISIC channel is cw.xdyzsn, where: 
M^is the controller type (for example, 1 is an ISIC board). 
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X is the controller number (for example, the EISA slot where the ISIC is located). 

y is the bus number. 

z is the SCSI ID of the drive. 

n is the number of the disk slice. 

The full pathname of a device is /dev/dsk/deWcena/we. In this document, 
only the device name is listed and /dev/dsk is assumed. An example of a 
device name is cO . OdOsO. 

The disk name (sometimes referred to as disk media name) is an optional 
administrative name for the disk, such as diskOL If you do not assign a 
disk name, the disk name defaults to disknn, where nn is a sequence 
number if the disk is being added to rootdg. OthenA^ise, the disk is named 
groupnamenn, where the groupname is the name of the group to which the 
disk is being added. 

Adding an Initialized Disk 

When you add a disk to a system under Volume Manager control, you must put the 
disk under Volume Manager control as well. If the disk has not been initialized 
before, initialize it by following the instructions in the section entitled ' 'Initializ- 
ing a Disk". If the disk has been initialized and partitioned into file systems pre- 
viously and you wish to keep the file systems, add the disk by doing these steps: 

1 . Go to the main menu and select menu item 1 (Add or initialize a 
disk). 
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r 



Volume Manager Support Operations 
Menu: VolumeManager/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Remove a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Enable access to (inport) a disk group 

9 Remove access to (deport) a disk group 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk infoxnation 

? Display help about menu 

?? Display help about the menuing system 

q Exit from menus 



Select an operation to perform: 1 



V 



J 



The Volume Manager prompts you with the following screen: 

rr 

Add or initialize a disk 
Menu: VolumeManager/Disk/AddDisk 

Use this operation to add a disk to a disk group. You can 
select Ein existing disk group or create a new disk group. You 
can also initialize a disk without adding it to a disk group, 
which leaves the disk available for use as a replacement disk. 
This operation takes, as input, a disk device, for example 
c0.0d2, a disk group (or none to leave the disk available for 
as a replacement disk) . If you are adding the disk to a disk 
group, you will be asked to give a name to the disk. 



Select disk device to add [<address>,list,g, ?] 



J 



If you do not know the address (device name) of the disk to be added, enter 
1 or list at the prompt. The Volume Manager displays a Hst of the disks 
available to the system: 
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DEVICE DISK GROUP STATUS 

cO.OdO diskOl rootdg online 

c0.0d2 - - error 

cl.4dl4 - - error 

Select disk device to add [<address>,list,g, ?] 

All disks attached to the system are recognized by the Volume Manager and 
displayed. 

The word error in the status line of cl .4dl4 tells you that a disk has not 
yet been added to Volume Manager control. These disks may or may not 
have been initialized before. The Disks that are listed with a disk name and 
disk group cannot be used for this operation, as they are already under 
Volume Manager control. 
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3 . Enter the address of the disk to be added. 



r 



DEVICE DISK GROUP STATUS 

cO.OdO diskOl rootdg online 

c0.0d2 - - error 

cl.4dl4 - - error 



Select disk device to add [<address>, list,g, ?] c0.0d2 



The Volume Manager displays the following prompt. 



f 



Disk device c0.0d2 does not appear to have been initialized for 
use vidth the voliune nianager. However, it may have been initialized 
for other purposes. You may want to encapsulate the existing 
disk partitions as volumes instead of adding it as a new disk. 



Do you wish to encapsulate c0.0d2? [y,n,q, ?] (default: y) 



Press ( Return ) to allow the Volume Manager to encapsulate the disk. This 
process adds a disk that has active partitions to Volume Manager control. 
This allows you to add active disks to Volume Manager control without los- 
ing any data. If the disk you wish to add is uninitialized, this screen does 
not display. 
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If you choose y to encapsulate, voldiskadm prompts you for the name of 
the disk group to which you want this disk assigned. 



r 



You can choose to add this disk to an existing disk group, to 
create a new disk groiQ}. To create a new disk group, select a 
disk grotQ} name that does not yet exist. 

Which disk grovQ} [<grovQ}>, llst,q, ?] (default; rootdg) 



V 



J 



Press ( Return ] to assign the disk to the default disk group rootdg. Oth- 
erwise, enter the name of the disk group to which you want the disk 
assigned. 



NOTE 



You can create other disk groups if necessary. (Instructions for 
creating a disk group are included later in this chapter.) How- 
ever, for most systems, the use of disk groups is not neces- 
sary. Therefore, the Volume Manager supports the default disk 
group, rootdg, in which all volumes are created if no further 
specification is given. All commands default to rootdg as well. 



5 . At this point, voldis kadm pro mpts you for a disk name for the disk being 
added. You can press ( Return ) to choose the default name or type in a 
disk name. 



r 



You must now select a disk name for the disk. This disk name 
Ccin be specified to disk removal, move, or replacement 
operations. If you move the disk, such as between host bus 
adapters, the disk will retain the same disk name, even though 
it will be accessed using a different disk device address name. 

Enter disk name [<name>,g, ?] (default: disk02) 



J 
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6. 



If you selected to encapsulate the disk and chose the the default disk group 
rootdg and the default disk name (in this case disk02), the following 
screen is displayed. 



r 



The requested operation is to encapsulate disk device c0.0d2 and 
to add this device to disk group rootdg as disk disk02. The 
system must be rebooted before this can take effect. 

Continue with operation? [y,n,q, ?] (default: y) 



J 



Press ( Return ] to encapsulate the disk. 
7 . The Volume Manager displays the following message: 



r 



The first stage of encapsulation for cO.OdO has conpleted 
successfully. You should now reboot your system at the earliest 
possible opportunity. The encapsulation will require two or three 
reboots which will happen automatically after the next reboot. 
To reboot execute the commcind: 

shutdown -gO -y -i6 

This will vQ)date the /etc/vfstab file so that volume devices eure 
used to mount the file systems on this disk device. You will need 
to update any other references such as backup scripts, databases, 
or manually created swap devices. 



Encapsulate another disk? [y,n,q, ?] (default: n) 



J 



Press ( Return ) to return to the main menu. 

Once you have added the disk, you must reboot the system before the Volume 
Manager can take over control of the disk. 
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Initializing a New Disk 

If the disk you wish to add has never been initialized, it can be initialized in the 
following manner: 



1 . From the main menu, select 1, Add or Initialize a disk. 

rr 

Volume Manager Support Operations 
Menu: VolumeManager/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Remove a disk 

4 Renusve a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Enable access to (inport) a disk grovp 

9 Renove access to (deport) a disk grovp 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 

? Display help about menu 
?? Display help about the nenuing system 
q Exit from menus 



Select an operation to perform: 1 



J 
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2. The Volume Manager prompts you for a disk device name. 



r 



Add or initialize a disk 

Menu : VolumeManager/Disk/AddDisk 

Use this operation to add a disk to a disk group. You can 
select an existing disk group or create a new disk group. You 
can also initialize a disk without adding it to a disk group, 
which leaves the disk available for use as a replacement disk. 
This operation takes, as input, a disk device, for example 
c0.0d2, a disk group (or none to leave the disk available for 
as a replacement disk) . If you are adding the disk to a disk 
group, you will be asked to give a name to the disk. 



Select disk device to add [<address>, list,q, ?] c0.0d2 



J 



3 . Once you select the disk device to be added, voldiskacam asks if you 
wish to initialize the disk. 



Press [ Return ) to initialize the disk. If you choose n, voldiskac3m 
returns you to the main menu. 



Do you wish to initialize c0.0d2? [y,n,g, ?] (default: y) 
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If you choose y, voldiskadm prompts you for the name of the disk group 
to which you want this disk assigned. 



r 



You can choose to add this disk to an existing disk group, to 
create a new disk group, or you can choose to leave the disk 
available for use by future add or replacenent operations. To 
create a new disk grovQ), select a disk groi;^) name that does not 
yet exist. To leave the disk available for future use, specify 
a disk group name of "none" . 

Which disk group [<groiq}>, none, list, q, ?] (default: rootdg) 



J 



Press ( Return ) to select the default disk group, rootdg. 



NOTE 



You can create other disk groups if necessary. (Instructions for 
creating a disl< group are included later in this chapter.) How- 
ever, for most systems, the use of disl< groups is not neces- 
sary. Therefore, the Volume Manager supports the default disk 
group, rootdg, in which all volumes are created if no further 
specification is given. All commands default to rootdg as well. 



5 . You are now prompted for a disk name. 



r 



You must now select a disk name for the disk. This disk name 
can be specified to disk removal, move, or replacement 
operations. If you move the disk, such as between host bus 
adopters, the disk will retain the same disk name, even though 
it will be accessed using a different disk device address name. 

Enter disk name [<name>,g, ?] (default: diskOl) 



V 



J 



Press ( Return 1 to select the default disk name or enter a disk name. 



2-16 



Unisys Volume l\/lanager Basic Uset's Guide 



The Volume Manager Support Operations 



6. If you selected the default disk group, rootdg and the default disk name, 
diskOl, voldiskaditi displays the following confirmation screen. 

The requested operation is to initialize disk device c0.0d2 and 
to add this device to disk' group rootdg as disk diskOl. 



Continue with operation? [y,n,g, ?] (default: y) 



J 



Press ( Return ) to initialize the disk. 

7. The Volume Manager now prepares to assign operating system partitioning 
to your disk. You can create separate operating systems for use with the 
DOS operating system. You must create one UNIX system partition. 

/ \ 

Initialize a disk 
Menu: VolumeManager/Disk/AddDisk 

The recommended default partitioning for your disk is: 

a 100% "UNIX System" partition. 

To select this, please type "y". To partition your disk 
differently, type "n" and the "fdlsk" program will let you 
select other partitions. 

Type y to select the default UNIX partitioning. If you want a different set 
up, enter n and follow the directions on the subsequent screens. 
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8. voldiskadm now asks if you wish the Volume Manager to do a surface 
analysis of the new disk. Since this disk has never been initialized, it is 
recommended that you allow the surface analysis to take place. 



Initialize a disk 

Menu: Volume^^anager/Disk/AddDisk 

Surface analysis may be necessary to locate any damaged blocks 
on the disk and to arrange for undamaged blocks to be used as 
replacements. This may take a few minutes to half an hour. 
You can skip this step, if you wish. However, it is advisable 
that you not skip this step xmless you are certain that this 
disk maintains its own list of damaged and replaconent blocks, 
and that this list is correct. If you aren't sure, do surface 
analysis. 

Perform surface analysis? [y,n,q, ?] (default: y) 



Press ( Return 1 to allow the surface analysis to take place. 

9 . The surface analysis can take several minutes to an hour depending upon 
the type and size of the disk. Once the surface analysis is complete, vol - 
diskacim returns the following success screen: 






J 




Disk initialization for c0.0d2 conpleted successfully. 




Add or initialize another disk? [y,n,q, ?] (default: n) 



J 



Press ( Return ) to return to the main menu. 
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Adding a Previously-Initialized Disk 

If the disk you wish to add has been used before, but not with UVM, you can 
encapsulate it, saving the information (see "Adding an Initialized Disk") or you 
can reinitialize the disk, allowing the Volume Manager to configure the disk for 
UVM. If you wish to have the disk reinitialized, do the following: 

1 . Select menu item 1 on the main menu. 

2. Select the device name of the disk you wish to reinitialize. 



Add or initialize a disk 

Menu: VolumeManager/Disk/AddDisk 

Use this operation to add a disk to a disk group. You can 
select an existing disk group or create a new disk group. You 
can also initialize a disk without adding it to a disk group, 
which leaves the disk available for vise as a replacement disk. 
This operation takes, as ii^t, a disk device, for exairple 
c0.0d2, a disk groi;^) (or none to leave the disk available for 
as a replacement disk) . If you are adding the disk to a disk 
grovp, you will be asked to give a name to the disk. 



Select disk device to add [<address>,list,q, ?] c0.0d2 



J 



3 . The Volume Manager asks if you want to encapsulate the disk. 



r 



Disk device c0.0d2 does not appeeu: to have been initialized for 
use with the volume manager. However, it may have been initialized 
for other purposes. You may want to encapsulate the existing 
disk partitions as volumes instead of adding it as a new disk. 

Do you wish to encapsulate c0.0d2? [y,n,q, ?] (default: y) n 



J 



Type n for no. 
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4. The Volume Manager asks if you wish to initialize the disk. 



Do you wish to initialize c0.0d2? [y,n,q, ?] (default: y) 



J 



Press ( Return ] to initialize the disk. 

5 . voldiskadm now asks you to select the disk group to which you want the 
disk added. 



r 



You can choose to add this disk to an existing disk groiQ}, to 
create a new disk group, or you can choose to leave the disk 
available for use by futiure add or replacement operations. To 
create a new disk group, select a disk group name that does not 
yet exist. To leave the disk available for future use, specify 
a disk group name of "none" . 

Which disk group [ <group>, none, list, q, ?] (default: rootdg) 



J 



Press [ Return ] to select the default disk group, rootdg, type in the name 
of your chosen disk group, or enter none. 



NOTE 



You can create other disk groups if necessary. (Instructions for 
creating a disk group are included later in this chapter.) How- 
ever, for most systems, the use of disk groups is not neces- 
sary. Therefore, the Volume Manager supports the default disk 
group, rootdg, in which all volumes are created if no further 
specification is given. All commands default to rootdg as well. 
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6 . The Volume Manager now prompts you for a disk name. 



r 



You must now select a disk name for the disk. This disk name 
can be specified to disk removal, move, or replacement 
operations. If you move the disk, such as between host bus 
adapters, the disk will retain the same disk name, even though 
it will be accessed using a different disk device address name. 

Enter disk name [<name>,q, ?] (default: diskOl) 



J 



Press ( Return ) to select the default disk name or enter a disk name. 

7 . The Volume Manager displays the following screen to confirm the opera- 
tion. ' 



r 



The requested operation is to initialize disk device c0.0d2 and 
to add this device to disk group rootdg as disk diskOl. 



Continue with operation? [y,n,q, ?] (default: y) 



J 



Press 1 Return ) to continue with the initialization. 
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8 . The disk must be partitioned. UVM displays this screen explaining the par- 
titioning scheme. 



r 



Initialize a disk 

Menu: VolumeManager/Disk/AddDisk 

The fdisk utility will now be invoked to allow you to select 
partitions to be used for the DOS operating system, and one 
fdisk partition to use for storing UNIX partitions. Please 
create exactly one partition with type UNIX. If you wish to be 
able to boot UNIX on this disk, you must also make the UNIX 
partition the active partition. 



Continue? [y,n,q, ?] (default: y) 



J 



Press ( Return 1 to continue. 
9. The fdisk utility sets up partitions similar to that shown below. 



r 



Total disk size is 100 cylinders (100.0 MB) 



Partition Status Type 

1 Active UNIX System 



SELECT ONE OF THE FOLLOWING: 



Cylinders J^ggrox. 
Start End Length % MB 

0 99 100 100 100.0 



1. Create a partition 

2. Change Active (Boot from) partition 

3. Delete a peurtition 

4. ppdate (Update disk configuration and exit) 

5. Exit (Exit without updating disk configuration) 
Enter Selection: 



J 



Select item 4 for UNIX systems and press ( Return 
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10. 



11 



The Volume Manager asks if you wish to have a surface analysis per- 
formed. If this disk has been used before and you are confident of its 
integrity, you can select n. If you are unsure of the disk, it is recommended 
that you allow the surface analysis to be performed. 



r 



Initialize a disk 

Menu : VolumeManager/Disk/AddDisk 

Surface analysis may be necessary to locate any damaged blocks 
on the disk and to arrange for undamaged blocks to be used as 
replacements. This may take a few minutes to half an hour. 
You can skip this step, if you wish. However, it is advisable 
that you not skip this step unless you are certain that this 
disk maintains its own list of damaged and replacement blocks, 
and that this list is correct. If you aren't sure, do surface 
analysis . 



Perform surface analysis? [y,n,q, ?] (default: y) 



J 



Press ( Return ] to allow the surface analysis to be performed. 

The surface analysis can take from a few minutes to an hour depending on 
the type and size of the disk. 

Once the surface analysis has finished, or immediately if you choose not to 
perform surface analysis, UVM returns the following display to notify you 
that the initialization was a success. 



r 



Disk initialization for c0.0d2 conpleted successfully. 



Add or initialize another disk? [y,n,q, ?] (default: n) 



J 



Press ( Return ) to return to the main menu. 
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Adding a Disk as a Spare 

If you wish to add a disk as a spare, follow the steps in ' 'Initializing a New Disk' ' 
or "Initializing a Previously-Initialized Disk". However, when you are asked to 
name a disk group, enter none instead of selecting rootdg or typing in a disk 
group name. The disk is then initialized as before, but held as a spare to be used 
at some later time. 

Display Disk Information 

Displaying a disk lets you check to see what disks are initialized, to which disk 
groups they belong, and the disk status. The list command displays device 
names for all recognized disks, the disk names, the disks groups names associated 
with each disk, and the status of each disk. To display disk information, do the 
following: 

1 . Select 1 or list on the main menu. 



r 



Volume Manager Support Operations 
Menu: VolumeManager/Disk 



1 
2 
3 
4 
5 
6 
7 
8 
9 

10 
11 



list 



Add or initialize a disk 
Encapsulate a disk 
Remove a disk 

Remove a disk for replacement 
Replace a failed or removed disk 
Mirror volumes on a disk 
Move volumes from a disk 
Enable access to (inport) a disk group 
Remove access to (deport) a disk group 
Enable (online) a disk device 
Disable (offline) a disk device 
List disk information 



q 



?? 



Display help about menu 

Display help about the menuing system 

Exit from menus 



Select an operation to perfoxm: 1 



J 
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voldiskadm displays the following screen: 

List disk information 
Menu: VolumeManager/Disk/ListDisk 

Use this menu operation to display a list of disks. You can 
also choose to list detailed information about the disk at 
a specific disk device address. 

Enter disk device or "all" [<address>,all,g, ?] (default: all) 

At the next prompt, enter the address of the disk you want to see or select 1 
or list for a list of all disks. If you select list, the Volume Manager 
displays the following information: 

DEVICE DISK GROUP STATUS 

cO.OdO cO.OdOsO rootdg online 

c0.0d2 diskOl rootdg online 

cl.4dl4 - - online 



Device to list in detail [<address>,none,q, ?] (default: none) 

Enter the address of the device on which you want information. Complete 
disk information, including the device name, the type of disk, and informa- 
tion about the public and private partiti ons of the disk, is shown. Once you 
have examined this information, press ( Return ) to return to the main 
menu. 
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Remove a Disk 

To remove a disk, first make sure it has no data on it, the data is no longer needed, 
or the data can be moved to other disks, then do the following: 

1 . Select menu item 3, Remove a disk, from the main menu to remove the 
disk from its disk group. 

(( \ 

Volume Manager Support Operations 
Menu: VolumeManeiger/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Rentove a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Enable access to (import) a disk group 

9 Remove access to (dqport) a disk groux> 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 



? Display help about menu 

?? Display help about the menuing system 

q Exit from menus 



Select an operation to perform: 3 



J 



NOTE 



You must disable the disk group before you can remove the last 
disk in that group. 



2. On the Remove a disk screen, select the disk name of the disk to be 
removed. 
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Remove a disk 

Menu: VolumeManager/Disk/RemoveDisk 

Use this operation to remove a disk from a disk group. This 
operation takes, as iiput, a disk name. This is the same name 
that you gave to the disk when you added the disk to the disk 
group. 



Enter disk name [<disk>,list,g, ?] 



J 



If there are any volumes on the disk UVM asks you whether they should be 
evacuated from the disk. If you wish to keep volumes, answer y . Other- 
wise, answer n. 



4. UVM displays a verification screen: 



r 



Requested operation is to ronove disk diskOl from group rootdg. 
Continue with operation? [y,n,q, ?] (default: y) 



J 



Press ( Return ] to continue. 

5 . UVM removes the disk from the disk group and displays the following suc- 
cess message. 



r 



Renoval of disk diskOl is complete. 



Remove another disk? [y,n,q, ?] (default: n) 



J 



Press ( Return ) to return to the main menu. 

You can now remove the disk or leave it on your system as a replacement 
disk. 
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Rename a Disk 

Rename a disk using the vol edit command explained in the section entitled 
"Rename a Disk" in Chapter 3. 

Disable (Offline) a Disic 

Occasionally, you may need to offline a disk. If the disk is corrupted, you need to 
offline it and remove it. You may be moving the physical disk device to another 
location to be connected to another system. To offline a disk, first remove it from 
any disk group, then do the following: 

1. Select menu item 11, Disable (offline) a disk device, from 
the main menu. 



r 



Volume Manager Support Operations 
Menu: VolumeManager/Disk 



4 
5 
6 
7 
8 
9 

10 
11 



1 
2 



list 



Add or initialize a disk 
Encapsulate a disk 
Remove a disk 

Remove a disk for replacement 
Replace a failed or removed disk 
Mirror volumes on a disk 
Move volumes from a disk 
Enable access to (import) a disk group 
Remove access to (deport) a disk group 
Eneible (online) a disk device 
Disable (offline) a disk device 
List disk information 



q 



7 

?? 



Display help about menu 

Display help about the menuing system 

Exit from menus 



Select an operation to perform: 11 



J 
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2. Select the disk you want to disable. 



Disable (offline) a disk device 
Menu: VolumeMcinager /Disk/Of flineDisk 

Use this menu operation to disable all access to a disk device 
by the volume manager. This operation can be applied only to 
disks that are not currently in a disk group. Use this operation 
if you intend to reniove a disk from a system without rebooting. 

NOTE: Many systems do not support disks that can be removed from 
a syston during normal operation. On such systans, the 
offline operation is seldom useful. 

Select a disk device to disable [<address>,list,q, ?] cl.4dl4 



3 . The Volume Manager disables cl .4dl4 and then asks if you want to disable 
another device. 



J 




Disable another device? [y,n,q, ?] (default: n) 




Press ( Return ) to return to the main menu. 
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Enable a Disk 

If you move a disk from one system to another during normal system operation, 
the Volume Manager does not recognize the disk automatically. Use this opera- 
tion to tell the Volume Manager to scan the disk to find what disk it is, and to 
determine if this disk is part of a disk group. Also, use this operation to re-enable 
access to a disk that was disabled by either the disk group deport operation or the 
disk device disable (oMne) operation. To enable a disk, do the following: 

1. Select menu item 10, Enable (online) a disk device, from the 
main menu. 



r 



Voliwie Manager Support Operations 
Menu: VolumeManager/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Remove a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Encible access to (iiiport) a disk group 

9 Remove access to (deport) a disk group 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 

? Display help about menu 

?? Display help about the menuing system 

q Exit from menus 



Select an operation to perform: 10 



J 
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2. Select the device name of the disk to be enabled or enter 1 for a list of dev- 
ices. 



r 



Enable (online) a disk device 
Menu: VoliimeManager/Disk/OnlineDisk 

Use this operation to enable access to a disk that was disabled 
with the "Disable (offline) a disk device" operation. 

You can also use this operation to re-scan a disk that may. have 
been changed outside of the volume manager. For exanple. If a 
disk is shared between two systems, the volume manager running on 
the other system may have changed the disk. If so, you can use 
this operation to re-scan the disk. 

NOTE: Many voldiskadm operations re-scan disks without user 

intervention. This will eliminate most needs to online a 
disk directly, except when the disk is directly offlined. 



Select a disk device to enable [<address>, list,q, ?] cl.4dl4 



J 



3 . The Volume Manager enables the device and displays the following suc- 
cess screen: 




Press ( Return ] to return to the main menu. 
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Replace a Disk 

If a disk fails, you need to replace that disk with another. This is referred to as 
replacing a disk. It requires disabling and removing the failed disk and installing 
a new disk in its place. To replace a disk, do the following: 

.1 . Select menu item 4, Remove a disk for replacement, from the 
main menu. 



r 



Volxome Manager Support Operations 
Menu: VolumeMeinager/Disk 



1 
2 
3 
4 
5 
6 
7 
8 
9 

10 
11 



list 



Add or initialize a disk 
Encapsulate a disk 
Remove a disk' 

Remove a disk for replaconent 
Replace a failed or removed disk 
Mirror volumes on a disk 
Move volumes from a disk 
Enable access to (import) a disk group 
Remove access to (deport) a disk group 
Enable (online) a disk device 
Disable (offline) a disk device 
List disk information 



q 



?? 



Display help about menu 

Display help about the menulng system 

Exit from menus 



Select an operation to perform: 4 



J 
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2. At the Remove a disk for replacement screen, enter the name 
of the disk to be replaced or enter 1 for a list of disks. 



r 



Remove a disk for replacenient 

Menu: VoliimeManager/Disk/RemoveForReplace 

Use this menu operation to ranove a physical disk from a disk 
group, while retaining the disk name. This changes the state 
for the disk name to a removed disk. If there are any 
initialized disks that are not part of a disk group, you vd.ll be 
given the option of using one of these disks as a r^lacement. 



Enter disk name [<disk>, list.g, ?] disk02 



J 



3 . Additional screens display if there are volumes associated with the disk you 
wish to remove. You must decide whether to keep the data associated with 
the volumes or to allow that data to be lost when the disk is replaced. 



4 . Select the replacement disk from the list provided in the next prompt 
screen. 



r 



The following devices are available as replacements: 
cl.4dl4 

You can choose one of these disks now, to r^lace disk02. 
Select "none" if you do not wish to select a replacement disk. 



Choose a device, or select "none" 
[<device>,none,g, ?] (default: cl.4dl4) 



J 



Press ( Return ) to choose the default disk. 
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5 . The Volume Manager displays the following screen: 

Requested operation is to remove disk disk02 from group rootdg. 
The removed disk will be replaced with disk device cl.4dl4. 

Continue with operation? [y,n,g, ?] (default: y) 

V J 



Press ( Return ] to continue. 

6 . As the Volume Manager successfully completes the operation, it displays 
the following screens: 



( \ 

Removal of disk disk02 completed successfully. 
Proceeding to replace disk02 with device cl.4dl4. 

V / 



Disk replacement completed successfully. 
Remove another disk? [y,n,q, ?] (defaxilt: n) 



Press ( Return ] to return to the main menu. 
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Replacing a Failed or Removed Disk 

Disks can be removed and then replaced later. To do this, follow the instructions 
for removing a disk provided in "Remove a Disk for Replacement' ' and do the 
following: 

1. Select menu item 5, Replace a failed or removed disk, from 
the main menu. 



Volvime Manager Support Operations 
Menu: VolumeManager/Disk 



1 
2 
3 
4 
5 
6 
7 
8 
9 

10 
11 



list 



Add or initialize a disk 
Encapsulate a disk 
Remove a disk 

Remove a disk for replaconent 
Replace a failed or renoved disk 
Mirror volumes on a disk 
Move volumes from a disk 
Enable access to (import) a disk group 
Remove access to (deport) a disk groi:^ 
Enable (online) a disk device 
Disable (offline) a disk device 
List disk information 



• q 



? 



?? 



Display help about menu 

Display help about the menuing system 

Exit from menus 



Select an operation to perform: 5 



J 
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2. Select the disk name of the disk to be replaced. 



r 



Replace a failed or removed disk 
Menu: VolumeManager/Disk/ReplaceDisk 

Use this menu operation to specify a replacement disk for a disk 
that you removed with the "Remove a disk for replacement" menu 
operation, or that failed during use. You will be prompted for 
a disk name to replace and a disk device to use as a replacement. 
You can choose an uninitialized disk, in which case the disk will 
be initialized, or you can choose a disk that you have already 
initialized using the Add or initialize a disk menu operation. 



Select a ronoved or failed disk [<disk>, list,q, ?] disk02 



J 



3 . The Volume Manager displays the device names of the the disk devices 
available for use as replacement disks. 



r 



The following devices are available as replacements: 

c0.0d2s0 cl.4dl4s0 

You can choose one of these disks to replace disk02. 
Choose "none" to initialize another disk to replace disk02. 

Choose a device, or select "none" 
[<device>,none,q, ?] (default: c0.0d2s0) 



J 



Press ( Return ] to select the default device or enter the device name of the 
device of your choice. 
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4. The Volume Manager displays a confirmation screen. 

the requested operation is to use the initialized device cO.Od2sO 
to replace the removed or failed disk disk02 in disk group rootdg. 

Continue with operation? [y,n,g, ?] (default: y) 



Press ( Return 1 to replace the disk. 
5 . The Volume Manager displays the following success screen: 

/ \ 

Replacement of disk disk02 in group rootdg with disk device 
c0.0d2s0 completed successfully. 

Replace another disk? [y,n,q, ?] (default: n) 



Press ( Return ) to retum to the main menu. 



Volume Operations 

This section describes the volume operations which can be performed with the 
Volume Manager Support Operations. These volume operations are used to pro- 
tect data in case of device failures. 

Mirror Volumes on a Disk 

Mirroring the volumes on a disk gives you one or more copies of your volumes in 
another disk location. By creating mirror copies of your volumes, you protect 
yourself against loss of data in case of a disk failure. 

Use this operations on your root disk to make a second copy of the boot informa- 
tion available on an alternate disk. This will allow you to boot your system even 
if your root disk is corrupted. 

To mirror volumes on a disk, make sure that the target disk has an equal or greater 
amount of space as the originating disk and then do the following: 
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1. Select menu item 6, Mirror volumes on a disk, from the main 
menu. 



r 



Volume Manager Sv;^ort Operations 
Menu: VolumeManager/Dlsk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Renove a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Enable access to (in^jort) a disk group 

9 Remove access to (deport) a disk group 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 

? Display help about menu 

?? Display help about the menuing system 

g Exit from menus 



Select an operation to perform: 6 



J 
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2. Select the disk name of the disk whose volumes you wish to mirror. 



r 



Mirror volumes on a disk 

Menu: VolumeManager /Disk/Mirror 

This operation can be used to mirror volumes on a disk. These 
volumes can be be mirrored onto another disk or onto any 
available disk space. Volumes will not be mirrored if they are 
already mirrored. Also, volumes that are coinprised of more than 
one subdisk will not be mirrored. 

Mirroring volumes from the boot disk will produce a disk that 
can be used as an alternate boot disk. 



Enter disk name [<disk>,list,q, ?] disk02 



V 



J 



3 . Select the target disk name (this disk must be the same size or larger than 
the originating disk). 



r 



V 



You can choose to mirror volumes from disk disk02 onto any 
available disk space, or you can choose to mirror onto a specific 
disk. To mirror to a specific disk, select the name of that disk. 
To mirror to any available disk space, select "any" . 

Enter destination disk [<disk>,list,g, ?] (default: any) diskOl 



J 



Be sure to always specify the destination disk when you are 
NOTE creating an alternate root disk. Otherwise, the Volume 

Manager will select a disk to be the alternate root disk; how- 
\ ever, your system may not be able to boot from that disk. 
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4. The Volume Manager displays the verifications screen: 



r 



The requested operation is to mirror all volumes on disk disk02 
in disk group rootdg onto available disk space on disk diskOl. 



NOTE: This operation can take a long time to conplete. 
Continue with operation? [y,n,q, ?] (default: y) 



J 



Press ( Return ) to make the mirror. 

5 . The Volume Manager displays the status of the operation as it performs the 
mirroring. 



Mirror volume voltest-bkOO . . . 
Mirroring of disk diskOl is complete. 



J 



6. Once the Volume Manager has completed the mirroring operation, it 
displays the following screen: 



Mirror volumes on another disk? [y,n,q, ?] (default: n) 



J 



Press ( Return ) to return to the main menu. 
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Move Volumes from a Disk 

Before you disable or remove a disk, you may want to move the data from that 
disk to other disks on the system. To do this, make sure that the target disks have 
sufficient space, then do the following: 

1. Select menu item 7, Move voliomes from a disk, from the main 
menu. 



r 



Volume Manager .Support Operations 
Menu : Vo lumeManager /Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Remove a disk 

4 Remove a disk for replacanent 

5 Replace a failed or removed disk 

6 Mirror volximes on a disk 

7 Move voliimes f rrai a disk 

8 Enable access to (import) a disk group 

9 Remove access to (d^Kjrt) a disk group 

10 Encible (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 

? Display help about menu 

?? Display help about the menuing system 

q Exit from menus 



Select an operation to perform: 7 



J 
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Select the disk name of the disk whose volumes you wish to move. 



r 



Move volumes from a disk 

Menu: VolumeManager /Disk/Evacuate 

Use this menu operation to move any volumes that are using a 
disk onto other disks. Use this menu immediately prior to 
removing a disk, either permanently or for replacement. 

NOTE: Sirtply moving volvmies off of a disk, without also removing 
the disk, does not prevent volumes from being moved onto 
the disk by future operations. For example, using two 
consecutive move operations may move volumes from the 
second disk to the first. 



Enter disk name [<disk>, list, q, ?] diskOl 



J 



2. The Volume Manager displays the following verification screen: 



r 



Requested operation is to move all volumes from disk diskOl in 

group rootdg. 



NOTE: This operation can take a long time to coirplete. 
Continue with operation? [y,n,q, ?] (default: y) 



J 



Press ( Return ) to move the volumes. 

3 . As the Volume Manager moves the volumes from the disk, it displays the 
status of the operation. 



f 



Move volume voltest 

Move volume voltest-bkOO 



J 



4. When the volumes have all been moved, the Volume Manager displays the 
following success screen: 
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rr ■ \ 

Evacuation of disk diskOl is conplete. 
Move voliimes from another disk? [y,n,q, ?] (default: n) 



Press ( Return ) to return to the main menu. 



Disk Group Operations 

The following sections describe disk group operations available with the Volume 
Manager Support operations. 

Create a Disk Group 

There can be situations in which all data related to a particular set of applications 
of a particular group of users needs to be made accessible on another system. 
Examples of this are: 

■ A system has failed and its data need to be moved to other systems. 

■ The work load must be balanced across a number of systems. 

In such cases, it is important that the data related to particular application(s) or 
users be located on an identifiable set of disk drives such that, when these drives 
are moved, all data of the application(s) or group of users on these disk drives is 
moved and no other data. 



NOTE 



On most systems, the use of disk groups is not necessary. Therefore, 
the Volume IVIanager supports a default disk group, rootdg, in which 
all volumes are created if no further specification Is given. All com- 
mands will default to rootdg as well. 

A disk group can only be created along with a disk. A disk group cannot exist 
with at least one disk associated with it. 

If you need to create a disk group in addition to rootdg, do the following: 
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1. On the main menu, select menu item 1, Add or Initialize a 
disk. 



r 



Volviine Manager Support Operations 
Menu: Volum^Manager/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Remove a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror volumes on a disk 

7 Move volumes from a disk 

8 Enable access to (iitport) a disk group 

9 Remove access to (deport) a disk groiqp 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 

? Display help about menu 

?? Display help about the menuing system 

q Exit from menus 



Select an operation to perform: 1 



J 



2. UVM prompts you with the following screen: 



r 



Add or initialize a disk 

Menu : Vol\]meManager /Disk/AddDi sk 



Use this operation to add a disk to a disk group. You can 
select an existing disk group or create a new disk group. You 
can also initialize a disk without adding it to a disk group, 
which leaves the disk available for use as a r^lacement disk. 
This operation takes, as irput, a disk device, for exanple 
c0.0d2, a disk group (or none to leave the disk available for 
as a replacement disk) . If you are adding the disk to a disk 
groiqp, you will be asked to give a name to the disk. 



Select disk device to add [<address>,list,q, ?] cl.4dl4 
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Select the address of the disk on which UVM will create the disk group. 
The following screen appears: 



r 



Disk device cl.4dl4 appears to have been initialized already. 
The disk is currently available as a replacement disk. 



Do you wish to reinitialize cl.4dl4? [y,n,g,?] (default: y) n 



V: 



J 



If you wish to reinitialize your disk, press ( Return ) . Otherwise, select n 
for no. 



3 . UVM now prompts you for the disk group name. 



r 



You can choose to add this disk to an existing disk group, to 
create a new disk group, or you can choose to leave the disk 
available for use fay future add or re^ilaceinent operations. To 
create a new disk groi;^, select a disk group name that does not 
yet exist. To leave the disk available for future use, specify 
a disk group name of "none" . 

Which disk group [<group>, none, list, q, ?] (default: rootdg) newdg 



J 



Enter the disk group name. In our example, newdg is the name of the new 
disk group. 
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4. The Volume Manager responds with: 



r 



There is no active disk group named newdg. 
Create a new group named newdg? [y.n,g, ?] (default: y) 



J 



Press ( Return ] to continue. 
5 . The Volume Manager prompts you for a disk name. 



r 



V 



You must now select a disk name for the disk. This disk name 
can be specified to disk removal, move, or replacement 
operations. If you move the disk, such as between host bus 
adapters, the disk will retain the same disk name, even though 
it will be accessed using a different disk device address name. 

Enter disk name [<name>,q, ?] (default: newdgOl 



J 



Press ( Return ) to c hoose the d efault disk name. Otherwise, type in a new 
disk name and press ( Return ] . 



6. UVM displays a confirmations window: 



r 



The requested operation is to create a new disk group named newdg 
containing disk device cl.4dl4. The disk will be named newdgOl 

within the disk group. 

Continue with operation? [y,n,q,?] (default: y) 



J 



Press ( Return ) to continue. 
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7 . Once the operation is complete, UVM returns the following display: 

Disk initialization for cl.4dl4 completed successfully. 
Add or initialize another disk? [y,n,q, ?] (default: n) 



Press ( Return ) to return to the main menu. 

Add a Disk to a Disk Group 

You may wish to add a new disk to an already established disk group. Perhaps the 
current disks have insufficient space for the project or work group requirements, 
especially if these requirements have changed. You can add a disk to a disk group 
by following the steps required to add a disk. Refer to the section entitled 
"Adding a Disk". 

Deporting a Disk Group 

Use this operation to disable access to a disk group that is currently enabled 
(imported) by this system. Deport a disk group if you intend to move the disks in 
a disk group to another system. Also, deport a disk group if you want to use all of 
the disks remaining in a disk group for some new purpose. 

To deport a disk group, do the following: 

1. Select menu item 9, Remove access to (deport) a disk 
group, from the main menu. 
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Volume Manager Support Operations 
Menu: Volum^Manager/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Remo\7e a disk 

4 Remove a disk for replacement 

5 Replace a failed or removed disk 

6 Mirror vol\imes on a disk 

7 Move volumes from a disk 

8 Enable access to (import) a disk group 

9 Remove access to (dejiort) a disk group 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 

? Display help about menu 

?? Display help about the menuing system 

q Exit from menus 

Select an operation to perform: 9 



2 . Select the disk group to be deported. 



r 



Remove access to (deport) a disk group 
Menu: VolumeManager/Disk/CreateDiskGroup 

Use this menu operation to remove access to a disk group that 
is currently enabled (incsorted) by this system. Deport a disk 
group if you intend to move the disks in a disk group to another 
system. Also, deport a disk group if you want to use all of the 
disks remaining in a disk group for some new purpose. 

You will be proirpted for the name of a disk group. You will 
also be asked if the disks should be disabled (of flined) . For 
removable disk devices on some systems, it is inportant to 
disable all access to the disk before removing the disk. 



Enter name of disk group [<groiQ)>,list,q, ?] (default: list) newdg 



J 
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3 . The Volume Manager displays a confirmation screen. 



r 



The requested operation is to disable access to the removable 
disk group named newdg. This disk grovp is stored on the 
following disks: 

newdgOl on device cl.4dl4s0 

You can choose to disable access to (also known as "offline") 
these disks. This may be necessary to prevent errors if 
you actually ranove any of the disks from the system. 

Disable (offline) the indicated disks? [y,n,q, ?] (default: n) 



J 



Press ( Return ] to deport the disk group. 
4. The Volume Manager asks if you wish to continue with the operation. 



r 



Continue with operation? [y,n,g, ?] (default: y) 



Press [ Return ) to continue. 

5 . Once the group is deported, the Volume Manager displays the following 
screen. 



r 



Removal of disk group newdg was successful. 
Disable another disk group? [y,n,q, ?] (default: n) 



V: 



J 



Press ( Return ] to go to the main menu. 
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Import a Disk Group 

Use this menu operation to enable access by this system to a disk group. If you 
wish to move a disk group from one system to another you must first disable 
(deport) it on the original system, then move the disk between systems and enable 
(import) the disk group. 

To import a disk group, do the following: 

1. Select menu item 8, Enable access to (import) a disk 
group, from the main menu. 



Volinne Manager Support Operations 
Menu: VolumeManager/Disk 



list 



1 
2 
3 
4 
5 
6 
7 

8 . 
9 

10 
11 



Add or initialize a disk 
Encapsulate a disk 
Remove a disk 

Remove a disk for replacement 
Replace a failed or removed disk 
Mirror vol\imes on a disk 
Move vol\imes fnsn a disk 
Enable access to (iirport) a disk group 
Remove access to (d^>ort) a disk group 
Enable (online) a disk device 
Disable (offline) a disk device 
List disk information 



?? 



Display help about menu 

Display help about the menuing system 

Exit from menus 



Select an operation to perform: 8 



J 
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2 . Select the name of the disk group to import. 



Enable access to (iirport) a disk group 
Menu: Volum^lanager/Disk/EnableDiskGroup 

Use this operation to enable access to a disk grovp. This can be 
used as the final part of moving a disk group from one system to 
another. The first part of moving a disk groi;^ is to use the 
"Remove access to (deport) a disk groiip" operation on the 
original host. 

A disk group can be imported from another host that failed without 
first deporting the disk group. Be sure that all disks in the disk 
group are moved between hosts. 

If two hosts share a SCSI bus, be very careful to ensure that the 
other host really has failed or has d^orted the disk group. If 
two active hosts import a disk group at the same time, the disk 
group will be corrupted and will become unusable. 

Select disk groi;^ to import [<group>,list,q, ?] (default: list) newdg 



3 . Once the import is complete, the Volume Manager displays the following 
success screen: 




J 




Ihe import of newdg was successful. 



Select another disk groi;^? [y,n,q, ?] (default: n) 



J 



Press ( Return ) to return to the main menu 
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Exiting the Volume l\/lanager Support Operations 

When you have completed all of your disk administration activities, be sure to exit 
the Volume Manager Support Operations. To exit from the Volume Manager Sup- 
port Operations, select menu item q from the main menu. 

/ \ 

Volume Manager SvqEiport Operations 
Menu: VoliimeManager/Disk 

1 Add or initialize a disk 

2 Encapsulate a disk 

3 Renove a disk 

4 Remove a disk for replacenent 

5 Replace a failed or ranoved disk 

6 Move volvaaes from a disk 

7 Create a rsnovable disk group 

8 Enable (import) a removable disk grov^ 

9 Disable (deport) a removable disk group 

10 Enable (online) a disk device 

11 Disable (offline) a disk device 
list List disk information 
? Display help about menu 
?? Display help about the menuing systan 
q Exit from menus 

Select an operation to perform: q 
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The Operation, Administration, and Maintenance (OA&M) menu interface is 
based on the Forms and Menu Language Interface (I^LI), a curses-based menu- 
ing package. OA&M controls administrative functions. 

The UVM interface with OA&M provides add-on menus to perform basic Volume 
Manager administration operations. 

The OA&M menus, by default, operate on the disk group listed in the 
/etc /default /volassist file. If this file does not exist or the disk group is 
not listed in this file, the OA&M menus operate on the disk group "rootdg." To 
change the defaults, use the Set Defaults menu. 



NOTE 



The OA&M menus are available only with UNIX System V, Version 4 
or later. If your system uses an earlier version of System V, you will 
not be able to use the OA&M menus. 

' Because of the continuing development of the OA&M menu interface, 
some of your screens may differ in appearance from those in this 
document. 

The buttons along the bottom of the OA&M screen are used as follows: 



( F1 ) =HELP (Help information about a command) 



[ F2 ] =CHOICES (The input choices available for a command) 



[ F3 ] =SAVE or ENTER (Accepts the input and processes the command) 



i F6 ] =CANCEL (cancel the current display and return to the previous 
display) 



[ F7 ) =CMD-MENU (brings up the command menu) 




Some of the OA&M buttons have more than one label. These buttons 
perform different actions at different times. The buttons listed In this 
document are those that are used most often. 
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Starting OA&M 

To initialize the OA&M menu interface, enter the following command: 
sysac3m 

The UNIX System V Administration menu appears (Figure 2-2). This menu pro- 
vides the interface to system administration functions. 



Figure 2-2: The System Administration Menu 



r 



UNIX System V/386 Operations, Adtninistration and Maintenance 

UNIX System V Administration 
backup_service - Backup Scheduling, Setup and Control 
£ile_3ystems - File System Creation, Checking and Mounting 
machine - Machine Configuration, Display and Shutdown 

netvK>rK_services - Network Services Administration 
ports - Port Access Services and Monitors 

preSVR4 - Peripherals Setup 

printers - Printer Configuration and Services 

restore_service - Restore From Backup Data 
schedule_task - Schedule Automatic Task 
software - Software Installation and Removal 

storage_devices - Storage Device Operations and Definitions 
systen)_setv^ - Systen Name, Date/Time and Initial Password Setvp 
users - User Login and Group Administration 

volume_!nagmt(old) - Unisys Voliime Manager Administration 
volumejnngmt (new) - Unisys Voliime Manager Administration 



Move the cursor to the item you want and press RETURN to select it. 



J 



The administration menu contains a list of several administration options. How- 
ever, the only operations currently supported are the Volume Manager OA&M 
operations, listed in the menu as volijme_ingint (new) and volLime_ingmt 
(old). 

The voluine_mgmt (new) option represents UVM 1.2.1 and includes new 
features that are not supplied with UVM 1.1.2. The vo liame_mgint (old) 
option represents UVM 1.1.2 and does not have the full functionality supplied 
with UVM 1.2.1. 
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Disk Operations 

This section describes the disk administration operations available to you using 
OA&M. However, because the voldiskadm menus are faster and simpler to 
use, it is recommended that you use the disk administration menus provided with 
the Volume Manager Support operations described in the beginning of this 
chapter. 



Adding a Disk 



Whenever you add a new disk to Volume Manager control, you must identify the 
new disk to the Volume Manager. If you want the disk to be under Volume 
Manager control, you must add the disk through the following procedure. 

1 . At the main menu, use the down arrow key on your k eyboard to move the 
cursor to voluine_mgmt (new) . Press ( Return 1 to select 
volume_mgint (new) . 



NOTE 



All of the operations in this section require you to select the 
voliime_mgmt (new) menu of OA&M. 

While working with menus and forms, you can retur n to a previ- 
ous menu or exit a form without saving by pressing fFSl (CAN- 
CEL). 



2. The Unisys Volume Manager menu pops up. 



r 



>Basic Disk Operations 
Basic Filesystem operations 
Basic Voliime Operations 
Display Disks 
Display Voliunes 
Set Defaults 



Iftiisys Volume Manager 

- Add, remove, and modify disks 

- Create, remove, and modify file systems 

- Create, remove, and modify volumes 

- Show disks under Volume Manager control 

- Display parameters of volumes 

- Set defaults for top down utilities 



J 



Move the pointer to Basic Disk Operations and press 
( Return ] . 
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3. On the Basic Disk Operations menu, select Add Disks 



r 



Basic Disk Operations 



Add Disks 
Encapsulate Disks 
Remove Disks 

Ranove Disk For Replacement 

Replace Disk 

Evacuate Disk 

Display Disks 

Enable (online) Devices 

Disable (Offline) Devices 



Add disks to VM and initialize 

Add disks to VM, preserving data 

Remove a disk from VM 

Ronove a disk for later replacement 

Replace failed or removed disk 

Move volumes from a disk 

Show information about dislcs in VM 

Enable checking of a disk device 

Disable checking of a disk device 



J 



4. In the Add Disks td VM windo w, fil l in the Device Address fiel(J. 
You can use the CHOICES button ( ( F2 ] ) to list all the devices available. 



r 



Device Address 



Add Disks to VM 
c0.0d2 



Disk Group 
Name for disk: 



rootdg 



J 
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5 . If the disk has not been previously initialized, the Volume Manager returns 
the following message: 

/ . \ 

Add Disks to VM 
Device Address c0.0d2 



Perfom surface analysis? yes 
Disk Group rootdg 
Name for disk: diskOl 



Press ( Return ) if you wish surface analysis to be performed. It is a good, 
idea to let the surface analysis be performed with a new or unknown disk 
device. 

If the disk has been previously initialized, the Volume Manager returns the 
following message: 

/ \ 

Add Disks to VM 
Device Address c0,.0d2 
The device c0.0d2 appears to have already been 
initialized and is currently available as a replacement 
disk. Reinitializing it will destroy its current 
configuration . 

Reinitialize disk? no 

Disk Group rootdg 
Name for disk: diskOl 

Press ( Return ] for no. 
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When you press ( Return ] , the cursor moves down to the Disk Group 
field. The Volume Manager supplies the default disk gro up, root dg. If 
you want your disk to be added to this disk group, press ( Return ] . If you 
wish the disk to belong to another disk group or to be kept as a spare, you 
must change the D isk Group field. Either enter the name of the disk 
group (press ( F2] for a list of available disk groups) to which you want the 
disk added or enter none in the Disk Group field. 

You can create other disk groups if necessary. (Instructions for 
creating a disk group are included in this chapter.) However, 
for most systems, the use of disk groups is not necessary. 
Therefore, the Volume Manager supports the default disk 
group, rootdg, in which all volumes are created if no further 
specification is given. All commands default to rootdg as well. 



NOTE 



r 



Device Address 



Add Disks to VM 
c0.0d2 



Perform surface analysis? 



Disk Group 
Name for disk: 



rootdg 
diskOl 



J 
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UVM moves the cursor 



After you select the disk group and press ( Return 

to the Name for disk : field. Either press ( Return J to accept the 
default disk name, or type in a name for ^e disk. 



r 



Device Address 



Add or Initialize A Disk 
c0.0d2 



Perform surface analysis? 



Disk Grovp 
Name for disk: 



rootdg 
diskOl 



J 



Press ( F3 ] (SAVE) to save your new disk information. If the disk needs to 
be initialized, the Volume Manager responds with the following several 



screens: 



r 



The fdisk will now be invoked to allow you to select fdisk 
partitions to be used for the DOS operating system, and one 
fdisk partition to use for storing UNIX partitions. Please 
create exactly one partition with type UNIX. If you wish to be 
able to boot UNIX on this disk, you must also make the UNIX 
partition the active partition. 



Press return to continue . . . 



J 



Press ( Return ) . 

9 . The next display shows the partitioning of the disk device. You can create 
partitions, changed the boot partition, delete a partition, update the disk 
configuration, or exit without updating the disk configuration (see the 
f disk(l) manual page for configuration information). 



Menu Interface Operations 



2-59 



The OA&M Menu Interface 



Unless you want a DOS disk, create only one UNIX partition to occupy 
100% of the disk and make the disk's status Active. 



r 



Total disk size is 100 cylinders (100.0 MB) 



Partition Status Type 

1 Active UNIX Systan 



Cylinders i^rox 
Start End Length % MB 



99 



100 



100 



100.0 



SELECT ONE OF THE FOLLOWING: 

1. Create a partition 

2. Change Active (Boot from) partition 

3. Delete a partition 

4. Update (Update disk configuration and exit) 

5. Exit (Exit without updating disk configuration) 
Enter Selection: 



J 



Select item number 5 and press ( Return ) . 
10. The Volume Manager prompts you to continue. 



r 



Press ENTER to continue 



J 



Press ( Return ) to continue. 
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1 1 . The Volume Manager displays the message: 

Setting iip disk c0.0d2 . . . 

as it prepares the disk for initialization. This will take some time, espe- 
cially when doing surface analysis. Surface analysis can take a few 
minutes to an hour depending on the type and size of the disk. 

The remainder of the messages shown in this document appear whenever 
you add a disk, with or without initializing it. 

12. The Volume Manager displays the following message as it adds the disk to 
the disk group. 

/ \ 

Adding device c0.0d2s0 to disk grovp rootdg as disk diskOl . . . 

13 . Once the disk has been added, the Volume Manager displays a Success 
window. 

/ \ 

Success 

The device c0.0d2 has been added to Volume Manager 
control as disk diskOl in disk groi;^ rootdg. 

If any errors occur, a window will appear containing the error messages 
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Display Disk Information 

Before you use a disk, you want to know if it has been initialized. You may need 
to know if the disk is part of a disk group, especially if the disks are grouped by 
application or user group. The list command displays device names for all 
recognized disks, the disk names, the disks groups names associated with each 
disk, and the status of each disk. To display disk information, do the following: 

1 . Select volume_mgmt (new) from the main menu. 

2. Select Display Disks in the Unisys Volume Manager menu. 



r 



Unisys Volume Manager 



Basic Disk Operations . 
Basic Filesystem operations 
Basic Volume Operations 
>Display Disks 
Display Volumes 
Set Defaults 



- Add, remove, and modify disks 

- Create, ranove, and modify file systems 

- Create, ranove, and modify volumes 

- Show disks under Volume Manager control 

- Display parameters of volumes 

- Set defaults for top down utilities 



J 



In the Display Disks window, select the disk you want information on 
or select all for a list of all disks under UVM control. 



r 



J 



Display Disks 



>all 
diskOO 
diskOl 
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If you select diskOl, the Volume Manager displays the disk name, device 
name, status, and length of diskOl. The list command also lists any 
volumes on the disk. Currently, there are no disks associated with diskOl. 

Display Disk diskOl 
Disk Name: diskOl Status: online 

Device Name: c0.0d2s0 Length: 202240 

Volumes on disk diskOl; 



J 



If you select all, the Volume Manager displays a list of all disks under its 
control. 



r 



DISK 



diskOO 
diskOl 



Display All Disks 
DEVICE LENGTH STATUS 



cO . OdOsO 
cO . 0d2s0 



143632 
660992 



CXILINE 
CmilNE 



Refer to the Unisys Volume Manager (UVM) System Administrator's . 
Gi//c/e for explanations of the fields shown in the display above. 
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Rename a Disk 

Rename a disk using the vol edit command explained in the section entitled 
"Rename a Disk" in Chapter 3. 



Remove a Disk 

If you find that you no longer need a disk in a particular disk group, you may want 
to remove it from the group and either put it in a new group or keep it as a spare. If 
the disk has volumes or file systems on it, they should be moved to other disks or 
removed. This is true unless the disk is failing. In that case, remove the disk as 
quickly as possible using Remove Disks For Replacement. To remove a 
disk from a disk group, do the following: 

1. Select Basic Disk Operations from the Unisys Volume 
Manager menu. 



2. Select the Remove Disks option. 



r 



Basic Disk Operations 



Add Disks 
Encapsulate Disks 
>Reinove Disks 

Remove Disk For Replacement 
Replace Disk 
Evacuate Disk 
Display Disks 
Enable (online) Devices 
Disable (Offline) Devices 
Removable Disks 



Add disks to VM and initialize 

Add disks to VM, preserving data 

Remove a disk from VM 

Remove a disk for later replacement 

Replace failed or removed disk 

Move volumes from a disk 

Show information about disks in VM 

Enable checking of a disk device 

Disable checking of a disk device 

Create and manipulate removable disks 



J 



3 . Enter the name of the disk in the Disk To Remove window. 



r 
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Disk To Remove 
Name of disk disk02 
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4. Press ( F3 ) (ENTER)to save your change. 

If there are any volumes or file systems on your disk, a window will pop up 
to tell you. You must decide whether to move the data to other disks or 
allow them to be lost when the disk is removed. If you wish to save the 
data, follow the instructions in the section entitled ' 'Move Volumes from a 
Disk." If there are no volumes or file systems on the disk, the Volume 
Manager displays a Success window. 



The disk dlsk02 has been removed from Volume Manager 



Disabling a Device 

Occasionally, you may need to disable a device. If the device is corrupted, you 
need to disable it and remove it. Or you may be moving the physical device to 
another location to be connected to another system. To disable a disk, you must 
first remove it from the disk group. See the previous section, "Remove a Disk." 
To disable a device, do the following: 

1. Select Basic Disk Operations from the Unisys Volume 
manager menu. 



r 



Unisys Volume Manager 



>Basic Disk Operations 
Basic Filesystem operations 
Basic Volume Operations 
Display Disks 
Display Volumes 
Set Defaults 



- Add, remove, and modify disks 

- Create, remove, and modify file systsns 

- Create, remove, and modify volumes 

- Show disks under Volume Manager control 

- Display parameters of volumes 

- Set defaults for top dovm utilities 



J 



2. Enter the name of the device in the Offline Devices window. 
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r 



J 



Name: 



Offline Disks 
c0.0cl2 



3. Ptess the ( F3 ] function key (ENTER) to save your change. 
The Volume Manager displays a Success window. 



r 



Disk device c0.0d2 successfully placed offline. 



J 



Replace a Disk 

If a disk fails, you need to replace that disk with another. This requires disabling 
and removing the failed disk and installing a new disk in its place. To replace a 

disk, you must first remove the disk for replacement. Then you can add a disk to 
replace the one you removed. To remove and replace a disk, do the following: 

1. Select Basic Disk Operations from the Unisys Volume 
manager menu. 



r 



>Basic Disk Operations 
Basic Filesystem operations 
Basic Volume Operations 
Display Disks 
Display Volumes 
Set Defaults 



Unisys Volume Manager 

- Add, remove, and modify disks 
Create, remove, and modify file systems 
Create, remove, and modify volumes 
Show disks under Volume Manager control 
Display parameters of volvmies 
Set defaults for top down utilities 



J 
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Select Remove Disk For Replacement from the Basic Disk 
Operations menu. 



r 



Basic 

Add Disks 
Encapsulate Disks 
Remove Disks 
>Remove Disk For Replacement - 
Replace Disk 
Evacuate Disk 
Display Disks 
Enable (online) Devices 
Disable (Offline) Devices 
Removable Disks 



Disk Operations 

' Add disks to VM and initialize 
Add disks to VM, preserving data 
Remove a disk from VM 
Ranove a disk for later replacement 
R^lace failed or removed disk 
Move volumes from a disk 
Show information about disks in VM 
Enable checking of a disk device 
Disable checking of a disk device 
Create and manipulate ranovable disks 



J 



3. Enter the name of the device in the Remove For Replacement win- 
dow. 



r 



Name of disk 



Remove For Replaconent 
disk03 



J 



4. Press the ( F3 ] function key (ENTER) to save your change. 
The Volume Manager displays a confirmation Window. 



r 



Confirm Removal Of Disk disk03 
You have requested to remove the disk disk03 for replacement. 

The following devices are currently available as 
replacements for disk disk03: 

cl.4dl4s0 cl.4d02s0 

If you wish to remove disk03 for replacement, press CONFIRM 
to confirm the operation. Otherwise, press CANCEL to abort. 



J 



Menu Interface Operations 



2-67 



The OA&M Menu Interface 



5 . Press the ( F3 ) function key to confirm. 

6. The Volume Manager displays a Success window. 



r 



Success 

The disk dlsk03 was successfully ranoved £or replacement. 



J 



7. Select Replace Disk from the Basic Disk Operations menu. 



r 



Basic 

Add Disks 
Encapsulate Disks 
Remove Disks 

Remove Disk For Replacanent - 
>Replace Disk 
Evacuate Disk 
Display Disks 
Enable (online) Devices 
Disable (Offline) Devices 
Removable Disks 



Disk Operations 

■ Add disks to VM and initialize 

■ Add disks to VM, preserving data 

■ Remove a disk from VM 

Remove a disk for later replacement 
Replace failed or removed disk 
Move volumes from a disk 
Show information about disks in VM 
Enable checking of a disk device 
Disable checking of a disk device 
Create and manipulate removable disks 



J 



In the Replace Disk window, put the name of the disk to be replaced in 
the D isk to replace field. If you need to see the disks available, press 
CES (CHOICES). 



r 



Replace Disk 



Disk to replace 
Replacement Device: 



disk03 



J 
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9. Enter the device name of the disk to be used as a replacement disk in the 
Replacement Device : field. 



r 



Replace Disk 
Disk to replace dlsk03 
Replacement Device: cl.4dl4 



J 



If you don't know what disks are available, press [ F2 ) (CHOICES) for a 
list of available devices. 



10. Press ( Return ] to add the disk. 

1 1 . The Volume Manager displays the following message: 



r 



Replace Disk 
Disk to replace disk03 
R^laceonent Device: cl.4dl4 



Perfom surface analysis? yes 



J 



12. Press ( F3 ) (ENTER) to save your changes. 

13 . The Volume Manager displays a Success window to notify you of the 
successful completion of the replacement. 
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Success 

The device cl.4dl4 has been added to Volume Manager 
control as a replacement for the disk disk03 in 
disk group rootdg. 
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Volume Operations 

This section describes the volume administration operations available to you 
using OA&M. 



Create a Volume 

To create a volume, do the following: 

1. Select Basic Volume Operations from the main menu. 
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Unisys Volume Manager 



Basic Disk Operations 
Basic Filesystem operations 
>Basic Volume Operations 
Display Disks 
Display Volumes 
Set Defaults 



- Add, remove, and modify disks 

- Create, remove, and modify file systems 

- Create, remove, and modify volumes 

- show disks imder Volume Manager control 

- Display parameters of volumes 

- Set defaults for top dov«n utilities 
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2. Select Create from the Basic Volume Operations menu. 
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Basic Volume operations 
>Create - Create a Volume 

Remove - Rsnove a Volume 

Display - Show Volumes Mirrors and Length 

Grow - Extend the Length of a Volume 

Shrink - Reduce the Length of a Volume 

Snapstart - Create a Mirror for the taking of a snapshot 
Snapshot - Take a Snapshot of a Volume 

Add Mirror - Add Mirrors to a Voliime 
Remove Mirror - Remove Mirrors from a Volume 
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In the Create Volumes window, enter the name of your new volume m 
the Vol lime Name: field 

/ \ 

Create Volumes 
Volume Name: voltest 

Volume Length: 

Number of Mirrors: 1 
Volume Layout: concat 



Logging Type: None 
Disk Group: rootdg 
Disk List: 
cO.OdOsO diskOl 

Enter the desired volume length. For information about volume length 

specifications, see the volintro man page. 
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Create Volumes 
Volume Name: voltest 
Volume Length: 100000 
Number of Mirrors: 2 
Volume Layout: concat 



Logging Type: None 
Disk Group: rootdg 



Disk List: 
cO.OdOsO diskOl 



5 . Press ( Return ] to select the default layout, or press ( F2 j (CHOICES) to 
choose another layout. See the Unisys Volume Manager (UVM) System 
Administrator's Guide for a description of alternate layouts. 



6. Press ( F3 ) (ENTER) to save the new volume. 
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7. The Volume Manager displays the following Success message window: 

Success 

VoliJine voltest has been successfully created. 

This produces a concatenated volume since the defaults were chosen. 

A concatenated volume consists of one or more sections of disk space (subdisks). 
This allows you to put together a volume larger than any individual section of free 
disk space available. 

Striped Volume 

A striped volume consists of a number of equal sized subdisks, each located on a 
separate disk drive. For more information on striping, refer to Chapter 1 . 

To create a striped volume, enter striped in the Volume Layout: field, the 
Number of stripes in the Number of stripes field, and the stripe width in 
the Stripe width field of the Create Volume window. 

For more information about striped volumes, see the Unisys Volume Manager 
(UVM) System Administrator's Guide. 

Displaying Volume Configuration Information 

If you are administering a volume created by someone else, you may want to 
know how this volume is configured. To display volume configuration informa- 
tion, do the following: 

1. Select the Basic Volume Operations menu. 

2. Select Display on the Basic Volume Operations menu. 
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Basic Volume operations 
Create - Create a Voliune 

Remove - Ranove a Volume 

>Display - Show Volumes Mirrors and Length 

Grow - Extend the Length of a Volume 

Shrink - reduce the Length of a Volume 

Snapstart - Create a Mirror for the taking of a snapshot 
Snapshot - Take a Snapshot of a Volume 

Add Mirror - Add Mirrors to a Volume 
Remove Mirror - Remove Mirrors from a Volume 
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3 . Select either all or the name of a specific volume from the Display 
Voliimes menu. 
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Display Volumes 



>all 
vol test 
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4. The Volume Manager displays the volume information. 
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Display all Volumes 

ASSOC KSTATE LENGTH 



COMMENT 



vol 
vol 



voltest 
voltest02 



fsgen ENABLED 1000000 
fsgen ENABLED 256 



For an explanation of the fields in this display, refer to the Unisys Volume 
Manager (UVM) System Administrator's Guide. 
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If you select to display one volume, such as voltest02, the display is similar 
to this: 
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Display Voliime voltest02 



TYPE 
vol 



NAME 

voltest02 



ASSCX: 
fsgen 



KSTATE 
ENABLED 



256 



COMMENT 



Number of mirrors on voltest02: 1 



Volume voltest02 occi^ies space on the following disks: 
diskOO disk03 
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For an explanation of the fields in this display, refer to the Unisys Volume 
Manager (UVM) System Administrator's Guide. 

Mirror a Volume 

A mirror (also called a plex) is a copy of a volume and its data. The mirror copy is 
not stored on the same disk(s) as the original copy of the volume. Mirroring a 
volume assure you that the data in that volume will not be lost if one of your disk 
fails. To mirror a volume, do the following: 

1. Select the Basic Volume Operations menu. 

2. Select Add Mirror. 
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Basic Volvane operations 
Create - Create a Volume 

Rsnove - Ronove a Volume 

Display - Show Voliimes Mirrors and Length 

Grow - Extend the Length of a Volume 

Shrink - reduce the Length of a Volume 

Snapstart - Create a Mirror for the taking of a snapshot 
Snapshot - Take a Snapshot of a Volume 
>Add Mirror - Add Mirrors to a Volume 
Remove Mirror - Ranove Mirrors from a Volvane 
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3 . Enter the name of the volume to be mirrored in the Mirror a Voliime 
window. 
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Mirror a Volume 
Mirror Volume named: voltest 



Layout For this mirror: 



concat, noncontig 
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4. Press ( F3 ) (ENTER) to create a new mirror. 



Remove a Mirror 

You may have more than one mirror for each volume. If you find that you have 
more mirrors than you need, you can remove a mirror. Or, if you feel the volume 
no longer needs to be mirrored (for example if the volume is no longer being 
actively changed and is archived somewhere) you can remove the only mirror of a 
volume. To remove a mirror, do the following: 

1 . Select the Basic Volume Operations menu. 

2. Select Remove Mirror. 
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Basic Volume operations 
Create - Create a Volume 

Remove - Rsnove a Volvane 

Display - Show Volumes Mirrors emd Length 

Grow - Extend the Laigth of a Volume 

Shrink - Reduce the Length of a Volimie 

Snapstart - Create a Mirror for the taking of a sne^shot 
Snapshot - Take a Snapshot of a Volume 

Add Mirror - Add Mirrors to a Volvane 
>Remove Mirror - Remove Mirrors from a Volume 
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3. The Remove Mirrors window appears. 
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Remove Mirrors 

Remove a Mirror from the Volume named: 
Number of Mirrors currently on this Volume: 
press Choices to Select Mirrors to Remove 



voltest 
3 
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Enter the name of the volume from which you want to remove a mirror. 

4. Select the mirr or you wish to remove. To get a list of mirrors available for 
removal, press [ F2) (CHOICES). The Volume Manager returns a Ust of 



mirrors. 
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Select Mirrors to be removed 
Select the mirrors using MARK 
and press ENTER. 

MIRROR DISKS OCCUPIED 
voltest-01 diskOO 
voltest-03 diskOS 
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Select the mirror to be removed and press ( F3 ] to remove the mirror. 
5 . The Volume Manager returns a Success window. 
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The mirror voltest-03 was successfully removed from 
the volvane voltest. 
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Extend a Volume 

If the volume is not large enough for the amount of data being stored in it, you 
need to extend the volume's length. To extend a volume, do the following: 

1. Select the Basic Voliime Operations menu. 

2. Select Grow. 



NOTE 



The Extend a Volume operation cannot be used with striped 
volumes. 



3 . Enter the name of the volume you want to extend in the Voliime name : 
field of the Extend a Volume's length menu. 

4. Enter either the amount you want to extend the volume by 



r 



Extend a Volume's Length 
Volume Name: voltest 
Current Length: 1000000 
Increase Length by: 100 
Increase Length to: 1000100 
All lengths in 512 byte sectors 



V 
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or the length you want to extend the volume to. 
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Extend a Volume's Length 
Volvane Name: voltest 
Current Length 1000000 
Increase Length by: 100 
Increase Length to: 1000100 
All lengths in 512 byte sectors 
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5 . Press [ F3 ] to save your change. 

6. The Volume Manager displays a Success window to inform you that it 



completed your volume extend successfully. 



Shrink a Volume 

If you find that your volume is much larger than you really need it to be, you can 
shrink the volume's size. To shrink a volume, do the following: 

1. Select the Basic Volume Operations menu. 



NOTE 



Be sure to back up any data in a volume prior to slirinking the 
volume. Othen/vise, data may be lost. 



2. Select Shrink. 

3 . Enter the name of the volume you want to shrink in the Volume Name 
field of the Reduce a Volume's Length menu. 
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Reduce a Volume's Length 
Volume Name: voltest 
Cuxxent Length: 1000100 
Decrease Length by: 100 
Decrease Length to: 1000000 
All lengths In 512 byte sectors 
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or the length you want to shrink the volume to. 
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Extend a Volume's Length 
Volume Name: vol test 

Current Length 1000100 
Decrease Length 1:^: 100 
Decrease Length to: 1000000 
All lengths in 512 byte sectors 
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4. Press [ F3 ] to save your change. 

5. The Volume Manager displays a Success window to inform you that it 
completed your volume shrink successfully. 



Remove a Volume 

Once a volume is no longer necessary (it is inactive and archived, for example), 
you can remove the volume and free up the disk space for other uses. To remove a 
volume, do the following: 

1. Select Basic Volume Operations. 

2. Select Remove. 

3 . Select the volume you wish to remove from the list of volumes in the 
Remove Volumes menu. 
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Remove Volximes 
Please select the volume to remove. 
Volijme Filesystem 
>voltest 
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4. Click the mouse button on the volume to be removed, the Volume Manager 
displays the following message: 
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Confirm Removal of Voliime voltest 
You have requested that the volume voltest be removed. 



If you still wish to remove the volume voltest, press CONFIRM 
to confirm the operation; otherwise, press CANCEL to abort. 



J 



5. Press [ F3 ) (CONFIRM) to remove the volume. 



Back Up a Volume 

It is very important to make back up copies of your volumes. This provides a 
copy of the data as it stands at the time of the backup. Backup copies are used to 
restore volumes lost due to disk failure, or data destroyed due to human error. 
Backing up a volume involves the following procedure: 

1. Select the Basic Voliime Operations menu. 

2. Select Snaps tart 
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Basic Volume operations 
Create - Create a Volume 

Remove - Remove a Volume 

Display - Show Volumes Mirrors and Length 

Grow - Extend the Length of a Volume 

Shrink - reduce the Length of a Volume 

>Snapstart - Create a Mirror for the taking of a snapshot 
Snapshot - Take a Snapshot of a Volume 

Add Mirror - Add Mirrors to a Volume 
Remove Mirror - Remove Mirrors from a Volume 
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3 . In the Snaps tart window, enter the name of the volume to be backed up 



Snaps tart 

Create a Backup Mirror for Volvune named: vol test 
Run in background? no 



4. Press [ F3 ) to create a backup mirror. 

The Volume Manager displays the following screen while it creates the 
backup mirror: 



Creating a backup mirror (this could take some time) 



5 . Once the backup mirror is created, the Volume Manager displays the fol- 
lowing message: 

rr \ 

Success 

A snapshot mirror has been attached to volume voltest and is 
now caught up. A snapshot volume can now be created using 
the snapshot operation. 



Press rF3l to CONTINUE. 
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6. In the Basic Volxame Operations menu, select Snapshot 
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Basic Volume operations 
Create - Create a Volume 

Remove - Remove a Volume 

Display - Show Volumes Mirrors and Length 

Grow - Extend the Length of a Volume 

•Shrink - reduce the Length of a Volume 

Snaps tart - Create a Mirror for the taking of a snapshot 
>Snapshot - Take a Snapshot of a Volume 

Add Mirror - Add Mirrors to a Volume 
Remove Mirror - Remove Mirrors from a Volume 
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7 . UVM prompts you for the name of the volume to be backed up. 
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Snapshot 

Take a snapshot of Volume named: voltest 
Name of snapshot Volume: 
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Enter the name of the volume. 

The Volume Manager fills in the Name of snapshot Volume : field 
with the default backup name. 
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Snapshot 

Take a snapshot of Volume named: voltest 
Name of snapshot Volume: voltest-bkOO 
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Press [ F3 ] to save the default name or choose a name for the backup 
volume and press ( F3) . 
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9 . Once the backup volume is created, the Volume Manager displays the fol- 
lowing Success window: 
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Success 



The volume voltest-bkOO is now a snapshot backup o£ volume voltest 
and is available for reading. 



J 



File System Operations 



This section describes the file system administration operations available with 
OA&M. 



Make and Mount a File System 

A file system is a collection of files that can be mounted on a volume. To make a 
file system, do the following: 



1. Select Basic Filesystem Operations menu. 
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Unisys Volume Manager 
Basic Disk Operations - Add, remove, and modify disks 

>Basic Filesystem operations - Create, remove, and modify file systems 



Basic Volume Operations 
Display Disks 
Display Volumes 
Set Defaults 



- Create, remove, and modify volumes 

- Show disks under Volume Manager control 

- Display parameters of volumes 

- Set defaults for top down utilities 
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2. On the File System Operations menu, select Create. 
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File System Operations 
>Create - Create and mount a File System on a Volvune 
Remove - Remove a File System 
Display - Show a File System's Attributes 
Grow - Extend the Length of a File System 
Shrink - Reduce the Length of a File System 



J 



3. In the Create a File System on a Volume, select the mount 
point directory for the new file system. 



Create a File System on a Volume 
File System mount point: /usr/pub/fstest 
Create filesystm on voltjme named: 
Length of filesystem (512 byte sectors) : 
File System type: vxfs 
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4. Press ( Return ] . 

The Volume Manager adds two lines to the Create a File System 
on a Volume menu. 
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Create a File System on a Volume 

File System mount point: /usr/pub/fstest 
Create filesystem on volume named: 
Length of filesystem (512 byte sectors) : 

File System type: vxfs 

Automatically mount on reboot? yes 

Mount now? yes 
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5 . Select the volume on which you want to create a file system or select to 
create a new volume. 
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Create a File Syston on a Volume 

File System mount point: /usr/pub/£stest 

Create filesystem on volume named: voltest 
Length of filesystem (512 byte sectors) : 

File System type: vxfs 

Automatically mount on reboot? yes 

Mount now? yes 
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6. Ptess ( Return ) . 

If the volume exists, the Volume Manager fills in the entire length of the 



volume in the Length of filesystem field. 
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Create a File Systen on a Volume 

File Syston mount point: /usr/pub/fstest 

Create filesystem on volume named: voltest 
Length of filesystem (512 byte sectors) : 10000 

File System type: vxfs 

Automatically mount on reboot? yes 

Mount now? yes 
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If the volume doesn't exist, OA&M displays the following screen: 
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volprint: Record voltest not found; 
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Ptess ( Return ) for the next screen. This screen instructs as follows: 




11 



Either press ( F2 ) for CHOICES, or enter make a new volume and 
follow the directions for making a new volume. 

Change the length of the file system to the length you want, or choose the 
default. 



8. Press [ Return ) . 

9. If you don't want the file system to mount automatically every time the sys- 
tem is rebooted, change the yes to no in the Automatically mount 
on reboot field. 

10. If you do not want to mount the file system immediately when you press 



[ F3 ] , change the yes to no in the Mount now? field. 



Press ( F3 ) to create the file system. 
The creation and mounting of the file system takes a few moments. 
12. Once the file system has been created and mounted, a Success window 



appears. 
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Success 



A file system of type vxfs has been created on the volume voltest. 
it has been mounted on the directory /usr/pub/fstest and will 
automatically be mounted there when the system is booted. 
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Removing a File System 

If a file system is no longer needed, you may wish to archive it and then remove it. 
After you have archived the file system, follow the steps below to remove the file 
system. 

1. Select the Basic Filesystem Operations menu. 

2. Select the Remove menu from the File System Operations menu. 
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File System Operations 
Create - Create and mount a File System on a Volume 
>Remove - Remove a File Systan 
Display - Show a File System's Attributes 
Grow - Extend the Length o£ a File Systen 
Shrink - Reduce the Length of a File Systan 
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3 . In the Remove File System menu, enter the name of the file system 
that you want to remove. 
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Remove File System 
Name of File System to ranove: /usr/pub/fstest 
This File System is on Volume: 
Remove Volume? yes 
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4. The name of the volume on which the file system resides appears in the 
" remove File Systems window. 
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Remove File System 
Name of File System to remove: /usr/pub/fstest 
This File System is on Volume: voltest 
Remove Volume? yes 
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5 . Press [ F3 ] if you wish to remove the entire volume. Otherwise, enter no in 
the remove Volume? field of the Remove File System window 
and then press ( F3 ) to remove the file system. 



Extending a File System 

If you find that your file system is not large enough to handle all the data, you can 
increase the length of the file system. To extend a file system, do the following: 



1. In the File System Operations menu, select Grow. 
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File System Operations 
Create - Create and mount a File System on a Volume 
Remove - Remove a File System 
Display - Show a File System's Attributes 
>Grow - Extend the Length of a File System 
Shrink - Reduce the Length of a File System 
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2. In the Extend the Length of a File System window, enter 
the mount point of the file system you want to extend. 



r 



Extend the Length of a File System 
Mount Point: /usr/pub/fstest 
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The volume name and current length of the volume appear in the Extend 

the length of a File system window. 
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Extend the Length of a File System 
Mount Point: /usr/pub/£stest 
Volume voltest 
Current Length: 10000 

Length Modifier 

New Length 
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Enter the new length in 512-byte sectors (or a plus sign (+) and the number 
of sectors by which you want the file system to grow) in the Length 
Modifier field. 
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Extend the Length of a File System 
Mount Point: /usr/pub/fstest 
Volume voltest 
Current Length: 10000 
Length Modifier +500 
New Length 10500 



J 



4. Press ( F3 ) to save the change. 



NOTE 



This operation is only possible with the VxFS advanced file system. 
The extend operation can not be done for file systems on striped 
volumes if the new length would exceed the size of the volume. 
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Shrinking a File System 

If you find that you have allocated more space for your file system than you need, 
you can decrease the size of the file system. To shrink the file system, do the fol- 
lowing: 

1. In the File System Operations menu, select Shrink. 
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File System Operations 
Create - Create ctnd mount a File System on a Volume 
Remove - Remove a File System 
Display - Show a File System's Attributes 
Grow - Extend the Length o£ a File Systan 
>Shrink - Reduce the Length of a File System 
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Enter the mount point of the file system in the Shrink the Length 
of a File System window. 
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Shrink the Length of a File System 
Mount Point: /usr/pub/£stest 
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3 . The volume name and the current length of the file system appear in the 
Shrink the Length of a File System window. 



Shrink the Length of a File System 
Mount Point: /usr/pub/fstest 
Volume voltest 
Current Length: 10500 

Length Modifier 

New Length 
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Enter the new length (or a minus sign (-) and the amount you want to shrink 
the file system) in the Length Modifier field. 
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Shrink the Length of a File System 
Mount Point: /usr/pub/fstest 
Volume voltest 
Current Length: 10500 
Length Modifier -500 
New Length 10000 
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5 . Press [ F3 ) to save the change. 



NOTE 



Shrinkage is only possible witli the VxFS advanced file system. You 
cannot shrink striped volumes. 



Display Mounted File Systems 

It is important to keep track of which file systems are mounted and which are not. 
This saves users from trying to access unmounted file systems. You can look at 
the status of file systems by doing the following: 

1. Select Display in the File System Operations menu. 
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File System Operations 
Create - Create and mount a File System on a Volume 
Remove - Remove a File System 
>Display - Show a File System's Attributes 
Grow - Extend the Length of a File System 
Shrink - Reduce the Length of a File System 
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2. Either select al 1 or the volume name of the volume for which you want to 
see the file system. 
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Display Mounted File Systems 
all 

voltest /usr/pub/fstest 



J 



If you select all, the Volume Manager displays all the mounted file sys- 
tems on all volumes under Volume Manager control. 
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Display Volumes With Mounted File Systems 
Mount Dir Filesystem blocks used avail %used 



/usr/pub/f 



/dev/vol /voltest 



500 106 394 21% 
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if you select a specific volume, the Volume Manager displays the following 
information concerning the file system. 
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Display Mounted File Systen voltest 
Moimt Dir Filesystem blocks used avail %used 



/usr/pub/ £stest 



(/dev/vol /voltest) : 
total : 



394 blocks 
500 blocks 



43 £iles 
48 files 
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For a full description of the fields shown in the displays above, refer to the 
Unisys Volume Manager (UVM) System Administrator's Guide 
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Quitting OA&IUi 

When you have finished your administrative tasks, be sure to exit OA&M. To exit 
the OA&M session, do the following: 

1 . Press the CMD-MENU key, ( F7 ) to view the Command menu. 

2. Position the pointer beside exit 

3 . Ptess [ Return ) to return to the command line prompt. 
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Introduction 



This chapter presents some of the most frequently-used admuiistrative commands 
provided by die Volume Manager. Each function is accompanied by the appropri- 
ate procedure(s) necessary to complete that function. 

For details on any of the commands mentioned in this chapter, refer to the 
appropriate manual pages in the Unisys Volume Manager (UVM) System 
Administrator's Guide. 

The functions described in this chapter can also be performed using the menu 
interfaces (the Volume Manager Support Operations and OA&M) in Chapter 2. 
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Disk Operations 



This section summarizes how to perfomi various disk and disk group operations. 
The majority of these operations can be performed more easily using the Volume 
Manager Support Operations menus (voldiskadm) discussed in Chapter 3. The 
voldiskadm menus are recommended for users new to the Volume Manager. 



Adding Dislcs 

When you add a disk to a system that is running the Volume Manager, you may 
wish to put the disk under control of the Volume Manager so that it can control the 
space allocation on the disk. If the disk was previously in use, but not under 
Volume Manager control, then you may wish to preserve existing data on the disk 
while still letting the Volume Manager take control of the disk. This can be 
accomplished using the encapsulation function of the Volume Manager. If the 
disk is new, then it will need to be initialized. If a disk was previously not under 
Volume Manager control, but no data is required to be preserved, an initialization 
operation should also be performed. 

When you perform disk administration, it is important that you recog- 
nize the difference between a device name and a disk name. 



NOTE 



The device name (sometimes referred to as devname or d/s/c access 
name) is the location of the disk. The syntax of a device name for an 
internal SCSI channel is cx./dzs/7, where: 

X is the controller type (for example, normally 0). 

y is the controller number (for example, normally 0). 

z is the logical disk number of the target disk. 

n is the number of the disk slice. 

The full pathname of a device is /dev/dsk/cfewicena/ne. In this docu- 
ment, only the device name is listed and /dev/dsk is assumed. An 
example of a device name is cO . OdOsO. 

The disk name (sometimes referred to as disk media name) is an 
administrative name for the disk, such as diskOI. If you do not assign 
a disk name, the disk name defaults to disknn, where nn is a 
sequence number if the disk is being added to rootdg. Othen/vise, 
the default disk name is groupnamenn, where groupname is the name 
of the disk group to which the disk is added. 
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Add a disk by entering the command: 
voldiskadd devname 

To add the device c0.0d2 to Volume Manager control^do the following: 
1. Enter: 

voldiskadd c0.0d2 



2. voldiskadd displays the following screen: 



r 



Add or initialize a disk 

Menu: Volum^lanager/Dislc/AddDisk 

Use this operation to add a disk to a disk group. You can 
select an existing disk group or create a new disk group. You 
can also initialize a disk without adding it to a disk group, 
which leaves the disk available for use as a replacement disk. 
This operation takes, as input, a disk device, for example 
c0.0d2, a disk group (or none to leave the disk available for 
as a replacement disk) . If you are adding the disk to a disk 
group, you will be asked to give a name to the disk. 

Disk device c0.0d2 does not appear to have been Initialized for 
' use with the volume manager. However, it may have been Initialized 
for other purposes. You may want to encapsulate the existing 
disk partitions as volumes instead of adding it as a new disk. 



Do you wish to encapsulate c0.0d2? [y,n,q,?] (default: y) 



J 



If you r disk is a lready partitioned and you want to keep the data as it is, 
press ( Return ) . If the disk has not been partitioned or if you don't need to 
keep the d ata on a previously-partitioned disk, enter n and press 
[ Return ) . 
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3 . Regardless of your answer in the previous screen, the Volume Manager 
prompts you for a disk group name. 

rr \ 

You can choose to add this disk to an existing disk group, to 
create a new disk group. To create a new disk group, select a 
disk group name that does not yet exist. 



Which disk group [<group>, llst,q, ?] (default: rootdg) 



J 



Press [ Return 1 to assign the disk to the default disk group rootdg. Oth- 
erwise, enter the name of the disk group to which you want the disk 
assigned or enter none to assign the disk as a spare. 



NOTE 



You can create other disk groups if necessary. (Instmctions for 
creating a disk group are included later In this chapter.) How- 
ever, for most systems, the use of disk groups Is not neces- 
sary. Therefore, the Volume Manager supports the default disk 
' group, rootdg, in which all volumes are created if no further 
specification is given. All commands default to rootdg as well. 

4. The Volume Manager now prompts you for a disk name (unless you entered 
none for a disk group, since spare disks do not get named). 

You must now select a disk name for the disk. This disk name 
can be specified to disk removal, move, or replacement 
operations. If you move the disk, such as between host bus 
adapters, the disk will retain the same disk name, even though 
it will be accessed using a different disk device address name. 

Enter disk name [<name>,q, ?] (default: diskOl) 
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If you selected to encapsulate the disk and chose the the default disk group 
rootdg and the default disk name (in this case diskO 1), the following 
screen is displayed. 

rr \ 

The requested operation Is to encapsulate disk device c0.0d2 and 
to add this device to disk group rootdg as disk dlskOl. The 
system must be rebooted before this can take .effect. 

Continue with operation? [y,n,q, ?] (default: y) 

If you are initializing a non-partitioned disk or reinitializing a previously- 
partitioned disk and selected the default disk group and disk name, the fol- 
lowing screen appears: 

rr \ 

The requested operation Is to Initialize disk device c0.0d2 and 
to add this device to disk group rootdg as disk dIskOl. 

Continue with operation? [y,n,q, ?] (default: y) 



In either case, press [ Return ] if you wish to continue with the chosen 
operation. 
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5. If you are encapsulating a disk, the following screen appears next: 



r 



The first stage of encapsulation for cO.OdO has conpleted 
successfully. You should now reboot your systan at the earliest 
possible opportunity. The encapsulation will require two or three 
reboots which will happen automatically after the next reboot. 
To reboot execute the connnand: 

shutdown -gO -y -16 

This will iqxlate the /etc/vfstab file so that volume devices are 
used to mount the file systems on this disk device. You will need 
to update any other references such as backup scripts, databases, 
or manually created swap devices. 

Encapsulate another disk? [y,n,q, ?] (default: n) 



Press ( Return 1 to exit the voldiskadd session. 

If you are initializing a non-partitioned disk, the next screen is: 



r 



Initialize a disk 

Menu: VolumeManager/Dlsk/AddOisk 

The recommended default partitioning for your disk is: 

a 100% "UNIX System" partition. 

To select this, please type "y". To partition your disk 
differently, type "n" and the "fdisk" program will let you 
select other partitions. 



J 



J 
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Type y to select the default UNIX partitioning. If you want a different set 
up, enter n and follow the directions on the subsequent screens. 

6 . If you selected to have UNIX partitioning for your non-partitioned disk or if 
you are repartitioning a previously partitioned disk, this will be your next 
screen: 

( 

Initialize a dls)c 
Menu: VolumeManager/Disk/AddOisk 

The fdlsk utility will now be Invoked to allow you to select 
partitions to be used for the DOS operating system, and one 
fdlsk partition to use for storing UNIX partitions. Please 
create exactly one partition with type UNIX. If you wish to be 
able to boot UNIX on this disk, you must also make the UNIX 
partition the active partition. 

Continue? [y,n,q, ?] (default: y) 

Press ( Return ] to continue. 
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7 . The fdisk utility partitions the disk in a manner similar to that shown below 

Total disk size Is 100 cylinders (100.0 MB) 

Cylinders Approx 
Partition Status Type Start End Length % MB 



Active UNIX System 0 99 100 100 100.0 



SELECT ONE OF THE FOLLOWING: 



1. Create a partition 

2. Change Active (Boot from) partition 

3. Delete a partition 

4. Update (Update disk configuration and exit) 

5. Exit (Exit without updating disk configuration) 
Enter Selection: 

Select item 5 for UNIX systems and press ( Return ) . 

8 . The Volume Manager asks if you wish to have a surface analysis per- 
fonned. If this disk has been used before and you are confident of its 
integrity, you can select n. If you are unsure of the disk, it is recommended 
that you allow the surface analysis to be performed. 
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Initialize a disk 
Menu: VolumeManager/Dlsk/AddOlsIc 

Surface analysis may be necessary to locate any damaged blocks 
on the disk and to arrange for undamaged blocks to be used as 
replacements. This may take a few minutes to half an hour. 
You can skip this step, if you wish. However, it is advisable 
that you not skip this step unless you are certain that this 
disk maintains its own list of damaged and replacement blocks, 
and that this list is correct. If you aren't sure, do surface 
analysis. 

Perform surface analysis? [y,n,q, ?] (default: y) 

Press [ Return ) to allow the surface analysis to be performed. 

The surface analysis can take from a few minutes to an hour depending on 
the type and size of the disk. 

9. Once the surface analysis has finished, or immediately if you choose not to 
perform surface analysis, UVM returns the following display to notify you 
that the initialization was a success. 

rr \ 

Disk initialization for c0.0d2 conpleted successfully. 
Add or initialize another disk? [y,n,q, ?] (default: n) 



Press [ Return ] to exit voldiskadd. 
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Reserving disks 

By default, volassist operations will allocate space from any disic that has 
free space. You may wish to reserve some set of disks for specif purposes, such 
as to avoid general use of a particularly slow or a particularly fast disk. To reserve 
a disk for special puiposes, enter: 

voledit set reserve=yes diskname 

After you enter this command, volas s i st will not allocate space from the 
selected disk imless that disk is specifically mentioned on the volassist com- 
mand line. For example, if disk diskO 3 is reserved, the command: 

volassist make vol03 20m diskOS 
creates a 20 megabyte volume on diskOS. However, the command: 

. volassist make vol04 
does not use diskOS, even if there is no free space on any other disk. 
To turn off reservation of a disk, enter: 

voledit set reserve=no diskname 



Display Disk information 

Before you use a disk, you need to know if it has been initialized. You need to 
know if the disk is part of a disk group, since you cannot create volumes on a disk 
that is not part of a disk group. The list command displays device names for all 
recognized disks, the disk names, the disk group names associated with each disk, 
' and the status of each disk. 

Display information on all disks that are defined to the Volume Manager as fol- 
lows: 

voldisk list 
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rr \ 

DEVICE TYPE DISK GROUP STATUS 

cO.OdOsO sliced cO.OdOsO rootdg online 

c0.0d2s0 sliced diskOl rootdg online 

Cl.4dl4s0 sliced - - online 



Display details on a particular disk defined to the Volume Manager as follows: 
voldisk list cO.Od2 



Add a Disk to a Disk Group 

You may wish to add a new disk to an already established disk group. Perhaps the 
current disks have insufficient space for the application or work group require- 
ments, especially if these requirements have changed. 

To add an initialized disk to a disk group, enter: 

voidiskadd devname 

To add device cl.4dl4 to rootdg, £>o the following: 
1. Enter the command: 

voidiskadd cl.4dl4 
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The Volume Manager displays the following message: 



r 



Add or Initialize a disk 

Menu: VolumeManager/Dlsk/AddOlsk 

Use this operation to add a disk to a disk group. You can 
select an existing disk group or create a new disk group. You 
can also Initialize a disk without adding It to a disk group, 
which leaves the disk available for use as a replacement disk. 
This operation takes, as Input, a disk device, for exanple 
c0.0d2, a disk group (or none to leave the disk available for 
as a replacement disk) . If you are adding the disk to a disk 
group, you will be asked to give a name to the disk. 

Disk device cl.4dl4 ai^ars to have been Initialized already. 
The disk Is currently available as a replacement disk. 



Do you wish to reinitialize cl.4dl4? [y,n,q,?] (default: y)n 



r 



You can choose to add this disk to an existing disk group, to 
create a new disk group, or you can choose to leave the disk 
available for use by future add or replacement operations. To 
create a new disk group, select a disk group name that does not 
yet exist. To leave the disk available for future use, specify 
a disk group name of "none". 

Which disk group [<group>,none,llst,g, ?] (default: rootdg) 



Enter n to add the disk without reinitializing it. 
2. The Volume Manager now asks you to choose a disk group. 



J 



J 



Press { Return 1 to select the default disk group, rootdg. 
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3 . The Volume Manager prompts you for a disk name. 



r 



You must now select a disk name for the disk. This disk name 
can be specified to disk removal, move, or replacement 
operations. If you move the disk, such as between host bus 
adapters, the disk will retain the same disk name, even though 
It will be accessed using a different disk device address name. 

Enter disk name [<name>,q, ?] (default: dlsk03) 



J 



Either enter a disk name or press [ Return 1 to select the default disk name. 
4. The following verification screen is displayed: 



r 



The requested operation is to add disk device cl.4dl4 to disk 
group rootdg as disk dlsk03. 

Continue with operation? [y, n,q, ?] (default: y) 



J 



Press [ Return ) to continue. 

5 . The Volume Manager adds the disk to disk group rootdg, displays a suc- 
cess message, and exits. 



r 



Disk initialization for cl.4dl4 completed successfully. 
Goodbye. 



J 



To see that the disk has been added to the disk group, enter: 
voldisk list 
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The Volume Manager returns: 



r 



DEVICE 
cO.OdOsO 
c0.0d2s0 
Cl.4dl4s0 



TYPE 
sliced 
sliced 
sliced 



DISK 
cO.OdOsO 
diskOl 
dislcOS 



GROUP 
rootdg 
rootdg 
rootdg 



STATUS 
online 
online 
online 



J 



Rename a Disk 

It isn't necessary to give your disks special names. The Volume Manager gives 
the disk a default name when you add the disk to Volume Manager control. The 
disk name is used by the Volume Manager to identify the disk's location or type. If 
you wish to change the disk name to reflect a change of ownership or use, enter: 

voiedit rename old_diskname new_diskname 

To rename diskOl to disk03, enter: 

voiedit renaone diskOl disk03 ■ 

To see if the name change took place, enter: 
.voldisk list 



The Volume Manager returns: 



DEVICE 
cO.OdOsO 
c0.0d2s0 
-Cl.4dl4s0 



TYPE 
sliced 
sliced 
sliced 



DISK 

cO.OdOsO 

disk03 



GROUP 

rootdg 

rootdg 



STATUS 
online 
online 
online 



J 
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Initialize a New Disk Group 

There can be situations in which all data related to a particular set of applications 
of a particular group of users needs to be made accessible on another system. 
Examples of this are: 

■ A system has failed and its data need to be moved to other systems. 

■ The woik load must be balanced across a number of systems. 

In such cases, it is important that the data related to particular application(s) or 
users be located on an identifyable set of disk drives, such that when these drives 
are moved, all data of the ^plication(s) or group of users is moved and no other 
data. 



NOTE 



On most systems, the use of disk groups is not necessary. Therefore, 
the Volume Manager supports a default disl< group, rootdg, in which 
all volumes aie created if no further specification is given. All commands 
will default to rootdg as well. 

To create the disk group newdg associated with disk02, enter: 
1. 

voldiskadd cl.4dl4 
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2 . Since cl .4dl4 has already been initialized, the Volume Manager asks if you 
wish to reinitialize it 



r 



Add or Initialize a dlslc 

Menu: VolumeManager/Dlsk/AddDlsk 

Use this operation to add a dlslc to a disk group. You can 
select an existing disk group or create a new disk group. You 
can also initialize a disk without adding It to a disk group, 
which leaves the disk available for use as a replacement disk. 
This operation takes, as input, a disk device, for example 
c0.0d2, a disk group (or none to leave the disk available for 
as a replacement disk) . If you are adding the disk to a disk 
group, you will be asked to give a name to the disk. 

Disk device cl.4dl4 appears to have been Initialized already. 
The disk Is currently available as a replacement disk. 



Do you wish to reinitialize cl.4dl4? [y,n,q, ?] (default: y)n 



J 



Enter n to add the disk to a disk group without reinitializing it. 
3 . The Volume Manager prompts you for a disk group. 



r 



You can choose to add this disk to an existing disk group, to 
create a new disk group, or you can choose to leave the disk 
available for use by future add or replacement operations. To 
create a new disk group, select a disk group name that does not 
yet exist. To leave the disk available for future use, specify 
a disk group name of "none". 

Which disk group [<group>, none, list, q,?] (default: rootdg) newdg 



J 



Enter the new disk group name and press ( Return 
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4. The Volume Manager responds with: 



r 



There Is no active disk group named newdg. 
Create a new group named newdg? [y,n,q,?] (default: y) 



J 



Press [ Return ] to continue. 
5 . The Volume Manager asks for a disk name. 



r 



You must now select a disk name for the disk. This disk name 
can be specified to disk removal, move, or replacement 
operations. If you move the disk, such as between host bus 
adapters, the disk will retain the same disk name, even though 
it will be accessed using a different disk device address name. 

Enter disk name [<name>,q, ?] (default: disk02) 



J 



Enter the disk name of your choice or press ( Return ) to select the default 
name. 



6. UVM displays a confirmations window: 



r 



The requested operation Is to create a new disk group named newdg 
containing disk device cl.4dl4. The disk will be named newdgOl 
within the disk group. 

Continue with operation? [y,n,q,?] (default: y) 



J 



Press [ Return j to continue. 
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7 . Once the operation is complete, the Volume Manager returns the following 
display: 



r 



Disk Initialization for cl.4dl4 conpleted successfully. 



Goodbye. 



8. Enter: 

voldisk list 
to see if the disk group was created. 



r 



DEVICE 



TYPE 



DISK 



GROUP 



cO.OdOsO sliced cO.OdOsO rootdg 



V: 



c0.0d2s0 sliced disk03 
cl.4dl4sO sliced dlsk02 



rootdg 
newdg 



STATUS 
online 
online 
online 



J 



J 



Display Disk Group information 

To use disk groups, you need to know what they are and what disks belong to each 
group. 

Display information on existing disk groups as follows: 

voldg list 
The Volume Manager returns the following: 



r 



NAME_ STATE ID 

rootdg enabled 730344554. 1025. harley 

newdg enabled 731118794. 1213. harley 



J 
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Display Free Space 

Before you add volumes and file systems to your system, you may want to make 
sure you have enough free disk space to adequately meet your needs. The Volume 
Manager lets you request a display of free space. 

To display free space for a group, enter: 

voldg free diskjgroup 

To see the free space in the default disk group, rootdg, enter: 

voldg free 
The Volume Manager returns: 



GROUP DISK DEVICE TAG OFFSET LENGTH FLAGS 

rootdg cO.OdOsO cO.OdOsO cO.OdO 726400 102672 

rootdg diskOl c0,0d2s0 c0.0d2 0 102128 

rootdg diskOl c0.0d2s0 c0.0d2 175856 26384 

rootdg disk02 cl.4dl4sO cl.4dl4 26624 175616 



The free space is measured in 512-byte sectors. 

Disable (Offline) a Disk 

Occasionally, you may need to disable (ofiffine) a disk. If the disk is corrupted, 
you need to disable it and remove it. You also must disable a disk before moving 
the physical disk device to another location to be connected to another system. 

To disable a disk, first remove the disk from its disk group. Then place a disk in 
an "offfine** state as follows: 

vol disk offline devname 

To take the device cl.4dl4s0 offfine, enter: 

voldisk offline cl.4dl4s0 
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NOTE 



The device name is used because the 6\sk is no longer In a disk group 
and so does not have an administrative name. 



Remove a Disk 

You can remove a disk to move it to another system or you may remove the disk 
because the disk is failing or has failed. However, before removing the disk from 
the current system, you must: 

■ Unmount the file system (see later in this chapter). 

■ Stop the volumes (see later in this chapter). 

■ Move the volumes to other disks or back up the volumes to tape (see later in 
this chapter). To move a volume, mirror the volume on one or more other 
disks, then remove the original copy of the volume. 

Alternatively, if the volumes are no longer needed, they can be removed. 

Removing a disk involves the following steps: 

1 . Remove the disk from its disk group. 
Remove a disk from a disk group as follows: 

voldg [-g groupname] rmdisk diskname 
where 

groupname is the name of the group to which the disk belongs. 
diskname is the name of the disk to be removed. 

For example, to remove diskOl from rootdg, enter: 
voldg rmdisk diskOl 

Since rootdg is the default disk group, you do not need to specify it. 

2 . Remove the disk from the Volume Manager and the system. 
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After removing a disk from its disk group, remove it from the system as fol- 
lows: 

voldisk rm devname 

For example, to remove c0.0d2 from Volume Manager control, enter: 
voldisk rm cl.4d03s0 
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This section summarizes various volume operations using the volassist 
command . 

volassist is the simplest and most powerful Volume Manager command. 
While many of these operations can be performed using the UVM OA&M menus 
described in Chapter 2, the volassist command is generally easier and faster. 



NOTE 



The file /etc/def auit/voiassist contains default options for 
volassist. This file can be edited to change the default behavior of 
volassist on your system. 



volassist contains an online help program to help you use volassist 
e£fectively. To activate the online help, enter: 

volassist help 



The volassist help command displays the following information: 

volassist - Perform slnqple general administrative actions 

Usage: volassist [-D debugopt I, .. .] ] [-g diskgroup] [-U usetype) % 

[-d file] -b keyword arg ... 
Recognized keywords: 

make volume_name length [options] 
mirror volume_name [options] 
move volume_name [options] 
growto volume_name new_length [options] 
growby volume_name length_change [options] 
shrinkto volume_name new_length [options] 
shrinkby volume_name length_change [options] 
snapstart volume_name [options] 
snapwait volume_name 
snapshot volume_name snapshot_name 
help [debug | flags I options] 
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Create a Volume 

A volume is a logical disk device on which file systems and data bases can be 
created. 

Create a volume using system defaults as follows: 

volassist make volume_nanie length 

To create the volume voldef enter: 

volassist make voldef 10m 

This creates a 10 MB volume named voldef. 

Concatenated Volume 

A concatenated volume is a volume using one or more sections of disk space. On 
a fragmented disk, this allows you to put together a volume larger than any indivi- 
dual section of free disk space available. Create a concatenated volume as fol- 
lows: 

volassist make VOlume_name length layout=concat 

To create the concatenated volume volcat, enter: 

volassist make volcat 10m layout=concat 

Concatenation is typically set as the default in the volassist defaults file 
/etc/defaults/ volassist. 

Spanned Volume 

A spanned volume is a concatenated volume with sections of disk space spread 
across more than one disk. A spanned volume can be larger than the single largest 
disk, since it takes space from more than one disk. Create a spanned volume as 
follows: 

volassist make VOlume_name length layout=concat,span 
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The concatenated, spanned layout is the default. 
To create the spanned volume vol span, enter: 

volassist make volspan 1000m layout=concat, span 

Striped Volume 

A striped volume consists of a number of equal sized subdisks, each located on a 
separate disk drive. For more information on striping, refer to Chapter 1. Create a 
striped volume as follows: 

volassist make VOlume_nanie lengUl layout=stripe 

To create the striped volume vol zebra, enter: 

volassist make volzebra 10m layout=stripe 

This creates a volume with the default stripe width on the default number of 
drives. 

Volume on Specific Disic 

The Volume Manager automatically selects the disk or disks each volume will 
reside on, unless you specify otherwise. If you want a volume to reside on a 
specific disk, you must designate the disk for the Volume Manager. Create a 
volume on a specific disk as follows: 

volassist make volume_name length diskname [...] 

More than one disk can be specified. 

To create the volume vol spec on disk03, enter: 

volassist make volspec 3m disk03 
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Display Volume Configuration Information 



If you are administering a volume created by someone else, you may want to 
know how this volume is configured. 

Display the volume, minor, and subdisk record information for all volumes as fol- 
lows: 

volprint -ht 
For example: 

/ 



D6 


NAME 


GROUP-ID 














DM 


NAME 


DEVICE 


TYPE 


DDTirr C<KT 


DT1DT TfKI 


PUBPATH 






V 


mrm 


USETYPE 
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STATE 
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PREFPLEX 


PL 
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VOLUME 
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LAYOUT 


ST-WIDTH MODE 


SD 
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DISKOFFS 
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DISK-MEDIA 


ACCESS 


dg 


rootdg 


730344554. 1025. harley 












dm 


cO . OdOsO 


cO.OdOsO 


sliced 


512 


829072 


/dev/rdsk/cO 


OdOse 


dm 


dlslcOl 


c0.0d2s0 


sliced 


512 


202240 


/dev/rdsk/cO. 


0d2se 


dm 


dls)c02 


cl.4dl4sO 


sliced 


512 


202240 


/dev/rdsk/cl . 4dl4se 


pl 


volmlr-02 




DISABLED 




10240 


CONCAT 




RW 


sd 


dis)c02-02 


volmlr-02 


0 


16384 
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dlsk02 




cl.4dl4s0 


V 


horaevol 


fsgen 
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pl 


homevol-01 


homevol 
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275184 


CONCAT 




RW 


sd 


cO.OdOsO-04 
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0 


410256 
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V 


rootvol 


root 


ENABLED 


ACTIVE 


314496 


SELECT 






pl 


rootvol-01 


rootvol 


ENABLED 


ACTIVE 


314496 


CaiCAT 




RW 


sd 


cO.OdOsO-01 


rootvol-01 


0 


95760 


314496 


cO.OdOsO 




cO.OdOsO 


V 


snapvol 


fsgen 


ENABLED 




20480 


ROUND 






pl 


voltest-03 


snapvol 


ENABLED 


ACTIVE 


20480 


CC»JCAT 




RW 


sd 


dlskOl-Ol 


voltest-03 


0 


143088 


20480 


diskOl 




c0.0d2s0 


V 


standvol 


gen 


ENABLED 


ACTIVE 


31248 


SELECT 






pl 


standvol-01 


standvol 


ENABLED 


ACTIVE 


31248 


CONCAT 




RW 


sd 


cO.OdOsO-03 


standvol-01 


0 


0 


31248 


cO.OdOsO 




cO.OdOsO 


V 


swapvol 


swap 


ENABLED 


ACTIVE 


64512 


SELECT 






pl 


swapvol-01 


swapvol 


ENABLED 


ACTIVE 


64512 


CONCAT 




RW 



J 



(continued on next page ) 
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r 



sd 


cO.OdOsO-02 


swapvol~01 


0 


31248 


64512 


cO.OdOsO 


cO.OdOsO 


V 


volcat 


fsgen 


ENABLED 


ACTIVE 


20480 


SELECT 




Pl 


volcat-01 


volcat 


ENABLED 


ACTIVE 


20480 


CWCAT 


RH 


sd 


cO.OdOsO-06 


volcat^Ol 


0 


705920 


20480 


cO.OdOsO 


cO.OdOsO 






f s en 


FNART.Fn 


ACTIVE 


6144 


SELECT 




P-«- 


volspGC~01 


voispec 


i?M&nT.pn 




K\ At 


CmCAT 


RW 


Su 


uXSKU^~UX 


volspeC'Ol 


n 
U 




DX44 


dlsk02 


Cl.4dl4s0 


V 


vol zebra 


fsgen 


ENABLED 


ACTIVE 


20480 


SELECT 


volstripe-01 


pl 


volzebra-01 


volzebra 


ENABLED 


ACTIVE 


20480 


STRIPE 128 RW 


Sd 


dlskOl-02 


volzebra-01 


0 


102128 


10240 


dlskOl 


c0.0d2s0 


sd 


cl.4dl4s0-01 


volzebra-01 


10240 


0 


10240 


dlslc02 


cl.4dl4s 


V 


voltest 


fsgen 


ENABLED 


ACTIVE 


20480 


SELECT 




pl 


voltest-01 


voltest 


ENABLED 


ACTIVE 


• 20480 


CCXICAT 


RW 


sd 


cO.OdOsO-05 


voltest-01 


0 


685440 


20480 


cO.OdOsO 


cO.OdOsO 


pl 


voltest-02 


voltest 


ENABLED 


ACTIVE 


20480 


CONCAT 


RW 


sd 


dlslcOl-04 


voltest-02 


0 


122608 


20480 


dIskOl 


c0.0d2s0 



J 



where: 




dg 


Is a disk group. 


dm 


Is a disk. 


pl 


Is a plex (or mirror). 


sd 


Is a subdisk. 


V 


Is a volume. 



Display volume-related information for a specific volume as follows: 
volprint -t volume_name 
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To display the infoimation about volspec, enter: 
volprint -t volspec 



r 



DG NAME 
DM NAME 
V NAME 
PL NAME 
SD NAME 



V 



volspec 



GROUP-ID 

DEVICE 

USETYPE 

VOUME 

PLEX 

fsgen 



TYPE PRIVLEN POBLEN 

KSTATE STATE LENGTH 

KSTATE STATE LENGTH 

PLOFFS DISKOFFS LENGTH 

ENABLED ACTIVE 6144 



PUBPATH 

READPOL PREFPLEX 
LAYOUT ST-WIDTH MODE 
DISK-MEDIA ACCESS 

SELECT - 



Mirror a Volume 

A mirror (plex) is a copy of a volume. The mirror copy is not stored on the same 
disk (s) as the original copy of the volume. Mirroring a volume assures you that 
the data in that volume will not be lost if one of your disks fails. 

Create a new volume with a mirror as follows: 

volassist make volume_name length mirror^yes 

To create the mirrored volume, volmir, enter: 

volassist make volmir 5m mirror«=yes 

Create a mirror for an existing volume as follows: 
volassist mirror volume_name 

For example: 

volassist mirror voltest 
creates a mirror of the volume voltest. 
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Remove a Mirror 



You may have more than one mirror (plex) for each volume. If you find that you 
have more mirrors than you need, you can remove a mirror. 

Removing a mirror involves the following procedure: 

1 . Dissociate the mirror from its volume. 

Dissociate the mirror from the volume as follows: 

voiplex dis plex_name 



For example, the volume volmir is a mirrored volume. 



r 



TYPE NAME 
vol volmlr 
plex volmir-01 
sd dlskOl-03 
plex volmir-02 
sd dlsk02-02 



ASSOC 

fsgen 

volmir 

volmir-01 

volmir 

volmir-02 



KSTATE 

ENABLED 

ENABLED 

ENABLED 



LENGTH COMMENT 
10240 
10240 
10240 
10240 
10240 



J 



To disassociate volmir-02 from the parent volume, enter: 
voiplex dis volmir-02 

2. Remove the mirror and any associated subdisks completely. 

After dissociating the plex from the volume, remove the plex and any associated 
subdisks as follows: 

vol edit -r rm plex_name 

Remove volmir-02 as shown below: 

voledit -r rm volmir-02 
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The output of volprint -h for volmir is: 



TYPE NAME 
vol volmir 
plex volmlr-01 
sd dlslcOl-03 



ASSOC 
fsgen 
volmir 



KSTATE 

ENABLED 

ENABLED 



LENGTH COMMENT 



volmir-01 



10240 
10240 
10240 



J 



Extend a Volume 



If the volume is not large enough for the amount of data that needs to be stored in 
it, you need to extend the volume's length. 

Extend a volume to a specific length as follows: 

volassist growto volume_nBme length 

To extend volcat to 2000 512-byte sectors, enter: 
volassist growto volcat 2000 

Extend a volume /?y a specific length as follows: 

volassist growby volume_name length 
To extend volcat by 100 sectors, enter: 

volassist growby volcat 100 

If you have the Unisys File System (VxFS) on the volume and you have installed 
the VxFS Advanced Features Package, you can use the fsadm command to grow 
or shrink the file system. Refer to the section entitled 'Tile System Operations" 
or to the Unisys File System (VxFS) System Administrator's Giy/de for more 
information on resizing file systems. 
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voiassist growto and voiassist growby cannot be used with 
striped volumes. 




Shrink a Volume 

If you find that your volume is much laiger than you really need it to be, you can 
shrink the volume's size. Shrink a volume to a specific length as follows: 

Do not shrink a volume below the size of the file system. If you 
have a VxFS file system, you can shrink the file system and then 
shrink the volume. If you do not shrink the file system first, you will 
lose data. 

voiassist shrinkto volume_name length 

Make sure not to shrink the volume t)elow current size of the file system or data- 
base using the volume. If the file system is VxFS Advanced, shrink the file system 
first, then shrink the volume. This command can be safely used on empty 
volumes. To shrink vol cat to 1300 sectors, enter: 

voiassist shrinkto volcat 1300 

Shrink a volume /}y a specific length as follows: 

voiassist shrinkby volunie_name lengUi 
To shrink volcat by 300 sectors, enter: 

voiassist shrinkby volcat 300s 



NOTE 



voiassist shrinkto and voiassist shrinkby cannot be USed 

with striped volumes. 
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Remove a Volume 

Once a volume is no longdr necessary (it is inactive and archived, for example), 
you can remove the volume and free up the disk space for other uses. 

To remove a volume, make sure the volume is stopped (using the volume stop 
command). The volume stop command stops ail Volume Manager activity to 
the volume. 

After stopping the volume, make sure the file systems are unmounted, then do the 
following: 

voiedit -rf rm volume_name 

To remove the volume vol span, enter: 

voiedit -rf rm volspan 



Back Up a Volume 

It is very important to make back up copies of your volumes. This provides a 
copy of the data as it stands at the time of the backup. Backup copies are used to 
restore volimies lost due to disk failure, or data destroyed due to human error. The 
Volume Manager allows you to back up volumes with minimal interruption of the 
volume's availability for users. Backing up a volume involves the following pro- 
cedure: 

1 . Create a snapshot mirror of the volume to be backed up. 

2. Select a suitable time to create a snapshot. You need to ensure that the data 
in the volume is in a consistent state and that no users are accessing the 
volume at the time the snapshot is taken. 

3 . Create a snapshot volume that reflects the original volume at the time of the 
snapshot 

4. The snapshot volume is a read-only volume that can now be used by back 
up utilities while the original volume continues to be available for applica- 
tions and users. 
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Create a snapshot minor for a volume as follows: 

voiassist snapstart volume_nanie 
To create a snapshot mirror of a volume called voldef, enter: 

voiassist snapstart voldef 

After creating the snapshot mirror, create a snapshot volume that reflects the origi- 
nal volume as follows: 

voiassist snapshot volume_name new_volume_name 

To create a snapshot volume of voldef, enter: 

voiassist snapshot voldef snapvol 
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This section summarizes how to create file systems on volumes. In most exam^ 
pies, the VxFS file system is used as it supports advanced operations, such as 
extending and shrinking file systems. 

lUlalce and IMount a File System 

A file system is created on a volume and cannot be larger than the volume on 
which it is created. 

Create a file system on a volume as follows: 

mkfs [-F vxfs] [generic_options] [-o specific_options] 
special Jile size 

where: 

vxfs is the vxfs file system type 

generic_opt'ons 

are the common file system options (such as -g). 

speclfic_options 

are options specific to this file system. 

special_file is the full pathname of the volume on which to create the file sys- 
tem (/dev/rvol/pubs). 

size is the size of the new file system. 

For more information about the options and variables available for use with the 
mkfs command, see the mk£s(l) manual page. 

If you want to use a file system wliich is expandable and has quick recovery, be 
sure to specify -F vxfs. 

To create a file system on a volume called /dev/rvol/pubs, first create the 
volume called pubs using volassist. Once the volume is created, enter: 

mkfs -F vxfs /dev/rvol/pubs 12288 

to create the file system. 
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NOTE 



The size of the file system (in this case 12288 sectors) is the same 
size or smaller than the volume on which the file system is mounted. 



The Volume Manager displays the following warning message: 

rr \ 

Mkfs: make vxfs file system? 
(DEL If wrong) 

and allows you approximately 10 seconds to change you mind. After the 10 
seconds, the file system is created and the Volume Manager displays the following 
message: 

r r \ 

12288 sectors, 6144 blocks of size 1024 
1320 Inodes, 5294 data blocks, log size 512 

1 allocation units of 5630 blocks, 1320 inodes, 5294 data blocks 
first allocation unit starts at block 514 
overhead per allocation unit is 336 blocks 

After creating the file system, mount it as follows: 

mount [-F vxfs] [generic_options] [-o specific_options] 
block_special mountjpoint 

To mount the file system /dev/ vol /pubs, enter 

mount -F vxfs /dev/ vol /pubs /pubs 
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Unmount a File System 

If you no longer need to access the data in a file system, you can unmount it 
Unmount a file system as follows: 

umount block_special I mountjpoint 
To unmount file system /dev/vol/pubs, enter. 

unmount /dev/vol/pubs 

Extend a File System 

If you find that your file system is not large enough, you can increase the length of 
the file system. The new size of the file system is specified in units of 512 byte 
blocks. 

Extend a vxfs file system as follows: 

fsadm [-F vxfs] [-b newsize] [-r rawdev] mountjpoint 
To extend vxfs file systems using ^ubs as a mount point, enter 

fsadm -F vxfs -b 22528 /pubs 

Slirinic a File System 

If you find that you have allocated more space for your file system than you need, 
you can decrease the size of the file system. 

Shrink a vxfs file system as follows: 

fsadm [-F vxfs] [-b newsize] [-r rawdev] mount jpoint 

Example 

To shrink vxfs file systems using ^ubs as a mount point, enter 
fsadm -F vxfs -b 20480 /pubs 
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The extend and shrink operations can only be done with VxFS 
Advanced file system. In cases where data is allocated towards the 
end of the file system, shrinkage may not t)e possible and may have 
to reoraanize the file system. See the VkFS System Administrator's 
Guidehr more information. 



Display Mounted File Systems 

It is important to keep track of which file systems are mounted and which are not. 
This saves users from trying to access unmounted file systems. You can look at 
the status of file systems by doing the following: 

mount 

The mount command displays the file system information similar to that shown 

below: 



r 



I on /dev/root read/wrlte/setuld on Sun Feb 21 17:45:22 1993 
/proc on /proc read/write on Sun Feb 21 17:45:24 1993 
/dev/fd on /dev/£d read/write on Sun Feb 21 17:45:24 1993 
/stand on /dev/vol/standvol read/write on Sun Feb 21 17:45:25 1993 
/Ihome on /dev/vol/homevol read/wrlte/delaylog/setuld/mlncache-closesync 
on Sun Feb 21 17:47:12 1993 
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I 



Glossary 



associate 



atomic operation 



blocic cliange 
logging 

concatenation 



configuration data- 
base 



device name 



disic 



disic access name 



The process of establishing a relationship between 
Volume Manager (UVM) objects; for example, a sub- 
disk that has been created and defined as having a start- 
ing point within a plex is referred to as being associ- 
atedmth that plex. 

An operation that either succeeds completely or fails 
and leaves everything as it was before the operation was 
started. If the operation succeeds, all aspects of the 
operation take effect at once and the intermediate stages 
of change are invisible. If any aspect of the operation 
fails, then the operation aborts without leaving partial 
changes. 

The way the Volume Manager (UVM) monitors and logs 
modifications to a mirror. A log of changed blocks is 
kept in an associated subdisk called a log subdisk. 

A layout style characterized by subdisks that are 
arranged sequentially and contiguously. 

A set of records containing detailed information on 
existing Volume Manager objects (such as disk and 
volume attributes). A single copy of a configuration 
database is called a configuration copy. 

The device name used to access a physical disk, such as 
cO . OdOsO. This is also referred to as the c//s/c access 
name. 

A collection of read/write data blocks that are indexed 
and can be accessed fairly quickly. Each disk has a 
universally unique identifier. 

The device name used to access a physical disk, such as 
cO . OdOsO. The term device name may also be used to 
refer to the c//s/c access name. 
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disk access records Configuration records used to specify the access paths to 

particular disks. Each disk access record contains a 
name, a type, and possibly some type-specific informa- 
tion, which is used by the Volume Manager (UVM) in 
deciding how to access and manipulate the disk that is 
defined by the disk access record. 



disk group 
disk ID 

disk media name 
disk media record 
dissociate 

free space 

initial swap area 
log subdisk 
mirror 



A collection of disks that share the same configuration 
database. The root diskgroupls a special private disk 
group that always exists. 

A universally unique identifier that is given to each disk 
and can be used to identify the disk, even if it is moved. 

A logical or administrative name chosen for the disk, 
such as disks. The temi disk name may also be used 
to refer to the disk media name. 

A configuration record that identifies a particular disk, 
by disk ID, and gives that disk a logical (or administra- 
tive) name. 

Dissociating Volume Manager (UVM) objects removes 
any link that exists between them; for example, dissoci- 
ating a subdisk from a mirror removes the subdisk from 
the mirror and adds the subdisk to the free pool. 

An area of a disk under UVM control that is not allo- 
cated to any volume or reserved for use by any Volume 
Manager object. 

The first disk region used as a swap area for the kernel. 

A subdisk that is used to store a block change log. 

A duplicate copy of a volume and the data therein (in 
the form of an ordered collection of subdisks). Each 
mirror is one copy of the volume with which the mirror 
is associated. The terms mirror and piexcm be used 
synonymously. 
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mirroring 
object 



partition 

persistent state log- 
ging 

plex 



private region 



public region 



A technique involving the use of multiple mirrors to 
make duplicate ^tentiaUy backup) copies of the infor- 
mation contained in a volume. 

An entity that is defined to and recognized internally by 
the Volume Manager. The UVM objects are: volume, 
plex, subdisk, disk, and disk group. There are actually 
two types of disk object — one for the physical aspect of 
the disk and the other for the logical aspect. 

The standard division of a physical disk device, as sup- 
ported directly by the operating system and disk drives. 

A logging type that ensures that only active mirrors are 
used for recovery puiposes and prevents failed mirrors 
from being selected for recovery. 

A duplicate copy of a volume and the data therein (in 
the form of an ordered collection of subdisks). Each 
mirror is one copy of the volume with wliich the mirror 
is associated. The temis mirror said plex cm be used 
synonymously. 

A region of a physical disk used to store private, struc- 
tured Volume Manager (UVM) information. The private 
re^/on contains a disk header, a table of contents, and a 
configuration database. The table of contents maps the 
contents of the disk. The disk header contains a disk ID. 
All data in the private region is duplicated for extra reli- 
ability. 

A region of a physical disk managed by the Volume 
Manager that contains available space and is used for 
allocating subdisks. 
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root configuration 



root disk group 

root file system 

root partition 
root volume 

spanning 

sparse mirror 

stripe 
striping 

subdlsl( 

swap area 



The configuration database for the root disk group. This 
is special in that it always contains records for other disk 
groups, which are used for backup purposes only. It also 
contains disk records that define all disk devices on the 
system. 

A special private disk group that always exists on the 
system. 

The initial file system mounted as part of the UNIX ker- 
nel startup sequence. 

The disk region on which the root file system resides. 

The UVM volume that contains the root file system, if 
such a volume is designated by the system configuration. 

A technique that permits a file or database too large to fit 
on a single disk to span across multiple physical disks. 

A mirror that is not as long as the volume or that has 
holes (regions of the mirror that don't have a backing 
subdisk). 

Relatively small, equally-sized areas that are allocated 
alternately on the subdisks of each striped mirror. 

A technique that spreads data across several physical 
disks using stripes. The data is allocated alternately to 
the stripes within the subdisks of each mirror. 

The internal representation of a portion of a physical 
disk. Subdisks can be allocated to mirrors to form 
volumes. 

A disk region used to hold copies of memory pages 
swapped out by the system pager process. 
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A UVM volume that is configured for use as a swap 
area. 



transaction 



volboot file 



hostid 



volume 



volume 
configuration 
daemon (void) 

volume 

configuration 

device 

volume event log 



A set of configuration changes that succeed or fail as a 
group, rather than individually. IVansactions are used 
internally to maintain consistent configurations. 

A small file that is used to locate copies of the root 
configuration. The file may list disks that contain 
configuration copies in standard locations, and can also 
contain direct pointers to configuration copy locations, 
volboot is stored in a system-dependent location. 

A string that identifies a host to the Volume Manager. 
The hostid for a host is stored in its volboot file, and is 
used in defining ownership of disks and disk groups. 

A virtual disk, representing an addressable range of disk 
blocks used by applications such as file systems or data- 
bases. A volume is a collection of from one to eight 
mirrors (mirrors). 

The Volume Manager (UVM) utility that is the interface 
between the kernel volconf ig device and the other 
Volume Manager (UVM) utilities. 

The volume configuration device (/dev/volconf ig) is 
the interface through which all configuration changes to 
the volume device driver are performed. 

The volume event log device (/dev/volevent) is the 
interface through wliich volume driver events are 
reported to the utilities. 



volume device driver The driver that forms the virtual disk drive between the 

application and the physical device driver level. The 
volume device driver is accessed through a virtual disk 
device node whose character device nodes appear in 
/dev/rvol, and whose block device nodes appear in 
/dev/vol. 
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